Pular para o conteúdo principal
Cria uma lista de comandos.

Sintaxe

Parâmetros

pDesc _In_
Tipo: D3D12XBOX_COMMAND_LIST_DESC*
A descrição da lista de comandos a ser criada. pCommandAllocator _In_
Tipo: ID3D12CommandAllocator*
Um ponteiro para o objeto ID3D12CommandAllocator a partir do qual o dispositivo cria listas de comandos. pInitialState _In_opt_
Tipo: ID3D12PipelineState*
Um ponteiro para o objeto 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
Tipo: REFIID
O GUID (identificador global exclusivo) da interface da lista de comandos. Para recuperar o REFIID (ou GUID) da interface para o estado do pipeline, use a macro __uuidof(). Por exemplo, para obter o GUID da interface para uma lista de comandos, faça o seguinte:
ppCommandList _Outptr_
Tipo: void**
Um ponteiro para um bloco de memória que recebe um ponteiro para a interface ID3D12CommandList ou 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.

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 e Criação e gravação de listas de comandos e pacotes. Para obter mais informações sobre como criar listas de comandos, confira CreateCommandList.

Requisitos

Cabeçalho: d3d12_x.h Biblioteca: d3d12_x.lib Plataformas com suporte: família XBOX One

Confira também

ID3D12Device
Última modificação em 6 de outubro de 2026