Pular para o conteúdo principal
Cria um objeto alocador de comandos.

Sintaxe

Parâmetros

type [in]
Tipo: D3D12_COMMAND_LIST_TYPE
Um valor do tipo D3D12_COMMAND_LIST_TYPE que especifica o tipo de alocador de comandos a ser criado. O tipo de alocador de comandos pode ser o tipo que registra listas de comandos diretas ou pacotes. riid
Tipo: const IID &
O identificador global exclusivo (GUID) da interface do alocador de comandos (ID3D12CommandAllocator). O REFIID, ou GUID, da interface do alocador de comandos pode ser obtido usando a macro __uuidof(). Por exemplo, __uuidof(ID3D12CommandAllocator) obterá o GUID da interface de um alocador de comandos. ppCommandAllocator [out]
Tipo: void **
Um ponteiro para um bloco de memória que recebe um ponteiro para a interface ID3D12CommandAllocator do alocador de comandos.

Valor retornado

Tipo: HRESULT Este método retornará E_OUTOFMEMORY se não houver memória suficiente para criar o alocador 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::CreateCommandAllocator da seguinte maneira:
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
Última modificação em 6 de outubro de 2026