> ## 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éta-commande spécifiée.

Crée une instance de la méta-commande 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 &

Référence à l'identificateur global unique (GUID) de la méta-commande que vous souhaitez instancier.

*NodeMask \[in]*\
Type : UINT

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

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

Pointeur facultatif vers une structure constante contenant les valeurs des paramètres de création de la méta-commande.

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

Valeur [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 celui-ci est défini, sinon 0.

*riid*\
Type : const IID &

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

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

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

### Valeur renvoyée

Type : HRESULT

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

<table>
  <tr>
    <th>Valeur renvoyée</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/reference/graphics/d3d12/interfaces/id3d12device5/id3d12device5_public)


## Related topics

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