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

# CreateCommandQueue

> Cria uma fila de comandos.

Cria uma fila de comandos.

Confira também [ID3D12Device9::CreateCommandQueue1](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device9/methods/id3d12device9_createcommandqueue1_public).

## Sintaxe

```cpp theme={null}
HRESULT CreateCommandQueue(
    const D3D12_COMMAND_QUEUE_DESC  pDesc,
    const IID & riid,
    void  ppCommandQueue
)
```

### Parâmetros

*pDesc*\
Tipo: const D3D12\_COMMAND\_QUEUE\_DESC \*

Especifica um **D3D12\_COMMAND\_QUEUE\_DESC** que descreve a fila de comandos.

*riid*\
Tipo: const IID &

O identificador global exclusivo (GUID) da interface da fila de comandos. Consulte **Comentários**. Um parâmetro de entrada.

*ppCommandQueue*\
Tipo: void \*\*

Um ponteiro para um bloco de memória que recebe um ponteiro para a interface [ID3D12CommandQueue](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/id3d12commandqueue_xs) da fila de comandos.

### Valor retornado

Tipo: HRESULT

Este método retornará **E\_OUTOFMEMORY** se não houver memória suficiente para criar a fila de comandos. Consulte [Códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues) para outros valores retornados possíveis.

## Comentários

O **REFIID**, ou **GUID**, da interface da fila de comandos pode ser obtido usando a macro \_\_uuidof(). Por exemplo, \_\_uuidof(ID3D12CommandQueue) obterá o **GUID** da interface de uma fila de comandos.

## Exemplos

O exemplo [D3D12HelloTriangle](https://learn.microsoft.com/en-us/windows/win32/direct3d12/working-samples) usa **ID3D12Device::CreateCommandQueue** da seguinte maneira:

```cpp theme={null}
D3D12_COMMAND_QUEUE_DESC queueDesc{};
queueDesc.Flags = D3D12_COMMAND_QUEUE_FLAG_NONE;
queueDesc.Type = D3D12_COMMAND_LIST_TYPE_DIRECT;

ThrowIfFailed(m_device->CreateCommandQueue(&queueDesc, IID_PPV_ARGS(&m_commandQueue)));
```

Consulte o [Código de exemplo na referência do D3D12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/notes-on-example-code).

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas compatíveis**: consoles XBOX Series e família XBOX One

## Confira também

* [ID3D12Device](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)
* [ID3D12Device9::CreateCommandQueue1](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device9/methods/id3d12device9_createcommandqueue1_public)


## Related topics

- [CreateCommandQueue1 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device9/methods/id3d12device9_createcommandqueue1_public.md)
- [D3D12_COMMAND_QUEUE_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_command_queue_desc_public.md)
- [D3D12_COMMAND_QUEUE_PRIORITY](/pt-BR/reference/graphics/d3d12/enums/d3d12_command_queue_priority_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)