CreateCommandList

Cria uma lista de comandos.

Sintaxe

HRESULT CreateCommandList(
    UINT nodeMask,
    D3D12_COMMAND_LIST_TYPE type,
    ID3D12CommandAllocator  pCommandAllocator,
    ID3D12PipelineState  pInitialState,
    const IID & riid,
    void  ppCommandList
)

Parâmetros

nodeMask [in]
Tipo: UINT Para operação com uma única GPU, defina como zero. Se houver vários nós de GPU, defina um bit para identificar o nó (o adaptador físico do dispositivo) para o qual a lista de comandos será criada. Cada bit na máscara corresponde a um único nó. Apenas um bit deve ser definido. Confira também Sistemas com vários adaptadores. type [in]
Tipo: D3D12_COMMAND_LIST_TYPE Especifica o tipo de lista de comandos a ser criada. pCommandAllocator [in]
Tipo: ID3D12CommandAllocator * Um ponteiro para o objeto alocador de comandos a partir do qual o dispositivo cria listas de comandos. pInitialState [in, optional]
Tipo: ID3D12PipelineState * Um ponteiro opcional para o objeto de estado de pipeline que contém o estado inicial do pipeline para a lista de comandos. Se for nullptr, o runtime definirá um estado inicial fictício do pipeline, para que os drivers não precisem lidar com um estado indefinido. A sobrecarga disso é baixa, especialmente para uma lista de comandos, cujo custo geral de gravação provavelmente supera em muito o custo de uma única configuração de estado inicial. Portanto, há pouco custo em não definir o parâmetro de estado inicial do pipeline, caso fazer isso seja inconveniente. Para pacotes, por outro lado, pode fazer mais sentido tentar definir o parâmetro de estado inicial (já que os pacotes provavelmente são menores em geral e podem ser reutilizados com frequência). riid [in]
Tipo: const IID & Uma referência ao identificador global exclusivo (GUID) da interface da lista de comandos a ser retornada em ppCommandList. ppCommandList [out]
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 Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, retornará um código de erro HRESULT.

Valor retornado	Descrição
E_OUTOFMEMORY	Não há memória suficiente para criar a lista de comandos.

Consulte Códigos de retorno do Direct3D 12 para outros valores retornados possíveis.

Comentários

O dispositivo cria listas de comandos a partir do alocador de comandos.

Exemplos

O exemplo D3D12Bundles usa ID3D12Device::CreateCommandList da seguinte maneira. Crie os objetos de pipeline.

ComPtr<ID3D12CommandAllocator> m_commandAllocator;
ComPtr<ID3D12GraphicsCommandList> m_commandList;

Crie um alocador de comandos.

ThrowIfFailed(m_device->CreateCommandAllocator(D3D12_COMMAND_LIST_TYPE_DIRECT, IID_PPV_ARGS(&m_commandAllocator)));

Criando a lista de comandos direta.

ThrowIfFailed(m_device->CreateCommandList(0, D3D12_COMMAND_LIST_TYPE_DIRECT, m_commandAllocator.Get(), nullptr, IID_PPV_ARGS(&m_commandList)));

Consulte o Código de exemplo na referência do D3D12.

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 ID3D12GraphicsCommandList::Reset

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Sintaxe

Parâmetros

Valor retornado

Comentários

Exemplos

Requisitos

Confira também

​Sintaxe

​Parâmetros

​Valor retornado

​Comentários

​Exemplos

​Requisitos

​Confira também

Sintaxe

Parâmetros

Valor retornado

Comentários

Exemplos

Requisitos

Confira também