> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateMetaCommand (consoles XBOX Series)

> Crée une instance de la métacommande spécifiée.

Crée une instance de la métacommande spécifiée.

## Syntaxe

```cpp theme={null}
HRESULT CreateMetaCommand(
    const GUID & CommandId,
    UINT NodeMask,
    const void  pCreationParametersData,
    SIZE_T CreationParametersDataSizeInBytes,
    const IID & riid,
    void  ppMetaCommand
)
```

### Paramètres

*CommandId \[in]*\
Type : const GUID &

Une référence à l'identificateur global unique (GUID) de la métacommande que vous souhaitez instancier.

*NodeMask \[in]*\
Type : UINT

Pour un fonctionnement avec un seul adaptateur, définissez cette valeur à zéro. S'il y a plusieurs nœuds d'adaptateur, définissez un bit pour identifier le nœud (l'un des adaptateurs physiques du périphérique) auquel la métacommande s'applique. Chaque bit du masque correspond à un seul nœud. Un seul bit doit être défini. Consultez [Systèmes multiadaptateurs](https://learn.microsoft.com/en-us/windows/win32/direct3d12/multi-engine).

*pCreationParametersData \[in, optional]*\
Type : const void \*

Un pointeur facultatif vers une structure constante contenant les valeurs des paramètres de création de la métacommande.

*CreationParametersDataSizeInBytes \[in]*\
Type : SIZE\_T

Un [SIZE\_T](https://learn.microsoft.com/en-us/windows/win32/WinProg/windows-data-types) contenant la taille de la structure pointée par <i>pCreationParametersData</i>, si ce paramètre est défini, sinon 0.

*riid*\
Type : const IID &

Une référence à l'identificateur global unique (GUID) de l'interface que vous souhaitez obtenir dans <i>ppMetaCommand</i>. Il doit s'agir du GUID de [ID3D12MetaCommand](/fr-CA/reference/graphics/d3d12/interfaces/id3d12metacommand/id3d12metacommand_public).

*ppMetaCommand \[out]*\
Type : void \*\*

Un pointeur vers un bloc de mémoire qui reçoit un pointeur vers la métacommande. Il s'agit de l'adresse d'un pointeur vers une interface [ID3D12MetaCommand](/fr-CA/reference/graphics/d3d12/interfaces/id3d12metacommand/id3d12metacommand_public), représentant  la métacommande créée.

### Valeur de retour

Type : HRESULT

Si cette méthode réussit, elle retourne **S\_OK**. Sinon, elle retourne un code d'erreur **HRESULT**.

<table>
  <tr>
    <th>Valeur de retour</th>
    <th>Description</th>
  </tr>

  <tr>
    <td width="40%">
      <dl>
        <dt>DXGI\_ERROR\_UNSUPPORTED</dt>
      </dl>
    </td>

    <td width="60%">
      Le matériel actuel ne prend pas en charge l'algorithme demandé
    </td>
  </tr>
</table>

## Configuration requise

**En-tête :** d3d12\_xs.h\
**Bibliothèque :** d3d12\_xs.lib\
**Plateformes prises en charge :** consoles XBOX Series

## Voir aussi

[ID3D12Device5](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device5/id3d12device5_public)


## Related topics

- [InitializeMetaCommand (consoles XBOX Series)](/fr-CA/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_initializemetacommand_public.md)
- [EnumerateMetaCommands (consoles XBOX Series)](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_enumeratemetacommands_public.md)
- [EnumerateMetaCommandParameters (consoles XBOX Series)](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_enumeratemetacommandparameters_public.md)
- [CreateCommandList1 (consoles XBOX Series)](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_createcommandlist1_public.md)
- [CreateCommandQueue1 (consoles XBOX Series)](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device9/methods/id3d12device9_createcommandqueue1_public.md)