> ## 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)

> Cria uma instância do metacomando especificado.

Cria uma instância do metacomando especificado.

## Sintaxe

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

### Parâmetros

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

Uma referência ao identificador global exclusivo (GUID) do metacomando que você deseja instanciar.

*NodeMask \[in]*\
Tipo: UINT

Para operação com um único adaptador, defina como zero. Se houver vários nós de adaptador, defina um bit para identificar o nó (um dos adaptadores físicos do dispositivo) ao qual o metacomando se aplica. Cada bit na máscara corresponde a um único nó. Apenas um bit deve ser definido. Consulte [Sistemas com vários adaptadores](https://learn.microsoft.com/en-us/windows/win32/direct3d12/multi-engine).

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

Um ponteiro opcional para uma estrutura constante que contém os valores dos parâmetros para criar o metacomando.

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

Um [SIZE\_T](https://learn.microsoft.com/en-us/windows/win32/WinProg/windows-data-types) que contém o tamanho da estrutura apontada por <i>pCreationParametersData</i>, se definido; caso contrário, 0.

*riid*\
Tipo: const IID &

Uma referência ao identificador global exclusivo (GUID) da interface que você deseja que seja retornada em <i>ppMetaCommand</i>. Espera-se que seja o GUID de [ID3D12MetaCommand](/pt-BR/reference/graphics/d3d12/interfaces/id3d12metacommand/id3d12metacommand_public).

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

Um ponteiro para um bloco de memória que recebe um ponteiro para o metacomando. Esse é o endereço de um ponteiro para um [ID3D12MetaCommand](/pt-BR/reference/graphics/d3d12/interfaces/id3d12metacommand/id3d12metacommand_public), que representa  o metacomando criado.

### Valor retornado

Tipo: HRESULT

Se este método for bem-sucedido, ele retornará **S\_OK**. Caso contrário, retornará um código de erro **HRESULT**.

<table>
  <tr>
    <th>Valor retornado</th>
    <th>Descrição</th>
  </tr>

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

    <td width="60%">
      O hardware atual não dá suporte ao algoritmo solicitado
    </td>
  </tr>
</table>

## Requisitos

**Cabeçalho:** d3d12\_xs.h\
**Biblioteca:** d3d12\_xs.lib\
**Plataformas com suporte**: consoles XBOX Series

## Consulte também

[ID3D12Device5](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device5/id3d12device5_public)


## Related topics

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