Método ID3D12Device4::CreateCommandList1 (d3d12.h)

Artigo
02/26/2024

Cria uma lista de comandos no estado fechado. Consulte também ID3D12Device::CreateCommandList.

Sintaxe

HRESULT CreateCommandList1(
  [in]  UINT                     nodeMask,
  [in]  D3D12_COMMAND_LIST_TYPE  type,
        D3D12_COMMAND_LIST_FLAGS flags,
  [in]  REFIID                   riid,
  [out] void                     **ppCommandList
);

Parâmetros

[in] nodeMask

Tipo: UINT

Para a operação de GPU única, defina isso como zero. Se houver vários nós de GPU, defina um bit para identificar o nó (adaptador físico do dispositivo) para o qual criar a lista de comandos. Cada bit na máscara corresponde a um único nó. Apenas um bit deve ser definido. Confira também Sistemas multi-adaptadores.

[in] type

Tipo: D3D12_COMMAND_LIST_TYPE

Especifica o tipo de lista de comandos a ser criada.

flags

Tipo: D3D12_COMMAND_LIST_FLAGS

Especifica os sinalizadores de criação.

[in] riid

Tipo: REFIID

Uma referência ao GUID (identificador global exclusivo) da interface de lista de comandos a ser retornada em ppCommandList.

[out] ppCommandList

Tipo: void**

Um ponteiro para um bloco de memória que recebe um ponteiro para a interface ID3D12CommandList ou ID3D12GraphicsCommandList para a lista de comandos.

Retornar valor

Tipo: HRESULT

Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele 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.

Confira Códigos de retorno do Direct3D 12 para obter outros valores de retorno possíveis.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10 Build 20348
Servidor mínimo com suporte	Windows 10 Build 20348
Plataforma de Destino	Windows
Cabeçalho	d3d12.h
Biblioteca	d3d12.lib
DLL	d3d12.dll

Confira também

ID3D12Device::CreateCommandList

Compartilhar via