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

# CreateCommandListX (família XBOX One)

> CreateCommandListX (consoles da família XBOX One) — Cria uma lista de comandos. Referência da API de gráficos do Direct3D 12 para desenvolvimento de jogos XBOX.

Cria uma lista de comandos.

## Sintaxe

```cpp theme={null}
HRESULT CreateCommandListX(  
         const D3D12XBOX_COMMAND_LIST_DESC* pDesc,  
         ID3D12CommandAllocator* pCommandAllocator,  
         ID3D12PipelineState* pInitialState,  
         REFIID riid,  
         void** ppCommandList  
)  
```

### Parâmetros

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

A descrição da lista de comandos a ser criada.

*pCommandAllocator*   \_In\_<br />Tipo: ID3D12CommandAllocator\*

Um ponteiro para o objeto [ID3D12CommandAllocator](/pt-BR/reference/graphics/d3d12_x/interfaces/ID3D12CommandAllocator/id3d12commandallocator) a partir do qual o dispositivo cria listas de comandos.

*pInitialState*   \_In\_opt\_<br />Tipo: ID3D12PipelineState\*

Um ponteiro para o objeto [ID3D12PipelineState](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/nn-d3d12-id3d12pipelinestate) que contém o estado inicial do pipeline para a lista de comandos.

Este parâmetro é opcional e pode ser definido como NULL. Se ele for definido como NULL, o runtime definirá um estado inicial de pipeline fictício para que os drivers encontrem um estado indefinido. A sobrecarga disso é baixa, especialmente para uma lista de comandos, para a qual o custo geral de gravação da lista de comandos é muito maior do que o de definir o estado inicial. Portanto, se não for conveniente definir o parâmetro de estado inicial do pipeline, há pouco custo em não defini-lo.

*riid*   <br />Tipo: REFIID

O GUID (identificador global exclusivo) da interface da lista 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 o estado do pipeline, 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 lista de comandos, faça o seguinte:

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

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

Um ponteiro para um bloco de memória que recebe um ponteiro para a interface [ID3D12CommandList](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/nn-d3d12-id3d12commandlist) ou [ID3D12GraphicsCommandList](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/id3d12graphicscommandlist) da lista de comandos.

### Valor retornado

Tipo: HRESULT

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

## Comentários

O dispositivo cria listas de comandos a partir do alocador de comandos. Para obter mais informações sobre alocadores de comandos, confira [CreateCommandAllocator](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12device-createcommandallocator) e [Criação e gravação de listas de comandos e pacotes](https://learn.microsoft.com/en-us/windows/win32/direct3d12/recording-command-lists-and-bundles#creating-command-lists).

Para obter mais informações sobre como criar listas de comandos, confira [CreateCommandList](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12device-createcommandlist).

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


## Related topics

- [CreateCommandList](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommandlist_public.md)
- [CreateCommandAllocator](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommandallocator_public.md)
- [CreateCommandQueue](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommandqueue_public.md)
- [CreateCommandSignature](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommandsignature_public.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)