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

# CreateCommandQueueX (família XBOX One)

> Cria uma fila de comandos no XBOX One.

Cria uma fila de comandos no XBOX One.

## Sintaxe

```cpp theme={null}
HRESULT CreateCommandQueueX(  
         const D3D12XBOX_COMMAND_QUEUE_DESC* pDesc,  
         REFIID riid,  
         void** ppCommandQueue  
)  
```

### Parâmetros

*pDesc*   \_In\_<br />Tipo: [D3D12XBOX\_COMMAND\_QUEUE\_DESC\*](/pt-BR/reference/graphics/d3d12_x/structs/d3d12xbox_command_queue_desc)

A descrição da fila de comandos.

*riid*   <br />Tipo: REFIID

O GUID (identificador global exclusivo) da interface da fila de comandos. Para recuperar o [REFIID](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-oaut/bbde795f-5398-42d8-9f59-3613da03c318) (ou GUID) da interface para a fila de comandos, use a macro [\_\_uuidof()](https://learn.microsoft.com/en-us/cpp/cpp/uuidof-operator?view=vs-2019). Por exemplo, para obter o GUID da interface para uma fila de comandos:

```cpp theme={null}
__uuidof(ID3D12CommandQueue)  
```

*ppCommandQueue*   \_Outptr\_<br />Tipo: void\*\*

Um ponteiro para um bloco de memória que recebe um ponteiro para a interface da fila de comandos.

### Valor retornado

Tipo: HRESULT

Um dos [códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues). Este método retorna E\_OUTOFMEMORY se não houver memória suficiente para criar a fila de comandos.

## Comentários

**CreateCommandQueueX** estende a função [CreateCommandQueue](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12device-createcommandqueue).

Somente uma fila de comandos de cada tipo pode ser criada no XBOX, a menos que a extensão **CreateCommandQueueX** seja usada para selecionar explicitamente um pipe/mecanismo e (para computação) um índice de fila para a fila de comandos. Somente uma única fila de comandos de gráficos pode ser criada, independentemente de qual API é usada. Uma fila de computação ou de cópia/DMA pode ser criada por pipe/mecanismo de GPU e índice de fila disponíveis.

<Note>
  As filas de comandos no Microsoft Game Development Kit (GDK) não são thread-safe. É responsabilidade do título sincronizar explicitamente o acesso por threads às filas de comandos de gráficos, de computação e de cópia/DMA. Não fazer isso pode levar à corrupção dos comandos emitidos na fila e a subsequentes travamentos ou falhas da GPU.
</Note>

## Requisitos

**Cabeçalho:** d3d12\_x.h

**Biblioteca:** d3d12\_x.lib

**Plataformas com suporte:** família XBOX One

## Confira também

[ID3D12Device](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)<br />[ID3D12CommandQueue](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/id3d12commandqueue)


## Related topics

- [CreateCommandQueue](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommandqueue_public.md)
- [XTaskQueueCreate](/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuecreate.md)
- [ID3D12CommandQueue::Signal](/pt-BR/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_signal_public.md)
- [D3D12_COMMAND_QUEUE_PRIORITY](/pt-BR/reference/graphics/d3d12/enums/d3d12_command_queue_priority_public.md)
- [D3D12_COMMAND_QUEUE_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_command_queue_desc_public.md)