> ## 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 (consolas XBOX Series)

> Crea una instancia del metacomando especificado.

Crea una instancia del metacomando especificado.

## Sintaxis

```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 &

Una referencia al identificador único global (GUID) del metacomando del que desea crear una instancia.

*NodeMask \[in]*\
Tipo: UINT

Para el funcionamiento con un solo adaptador, establézcalo en cero. Si hay varios nodos de adaptador, establezca un bit para identificar el nodo (uno de los adaptadores físicos del dispositivo) al que se aplica el metacomando. Cada bit de la máscara corresponde a un solo nodo. Solo debe establecerse un bit. Consulte [Sistemas con varios adaptadores](https://learn.microsoft.com/en-us/windows/win32/direct3d12/multi-engine).

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

Un puntero opcional a una estructura constante que contiene los valores de los parámetros para crear el metacomando.

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

Un [SIZE\_T](https://learn.microsoft.com/en-us/windows/win32/WinProg/windows-data-types) que contiene el tamaño de la estructura a la que apunta <i>pCreationParametersData</i>, si está establecido; de lo contrario, 0.

*riid*\
Tipo: const IID &

Una referencia al identificador único global (GUID) de la interfaz que desea que se devuelva en <i>ppMetaCommand</i>. Se espera que sea el GUID de [ID3D12MetaCommand](/reference/graphics/d3d12/interfaces/id3d12metacommand/id3d12metacommand_public).

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

Un puntero a un bloque de memoria que recibe un puntero al metacomando. Es la dirección de un puntero a un [ID3D12MetaCommand](/reference/graphics/d3d12/interfaces/id3d12metacommand/id3d12metacommand_public), que representa el metacomando creado.

### Valor devuelto

Tipo: HRESULT

Si este método se ejecuta correctamente, devuelve **S\_OK**. De lo contrario, devuelve un código de error **HRESULT**.

<table>
  <tr>
    <th>Valor devuelto</th>
    <th>Descripción</th>
  </tr>

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

    <td width="60%">
      El hardware actual no admite el algoritmo solicitado
    </td>
  </tr>
</table>

## Requisitos

**Encabezado:** d3d12\_xs.h\
**Biblioteca:** d3d12\_xs.lib\
**Plataformas compatibles**: consolas XBOX Series

## Consulte también

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


## Related topics

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