Share via


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

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

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