Compartilhar via


Método ID3D12Device9::CreateCommandQueue1 (d3d12.h)

Cria uma fila de comandos com uma ID do criador.

Consulte também ID3D12Device::CreateCommandQueue.

Sintaxe

HRESULT CreateCommandQueue1(
  const D3D12_COMMAND_QUEUE_DESC *pDesc,
  REFIID                         CreatorID,
  REFIID                         riid,
  void                           **ppCommandQueue
);

Parâmetros

pDesc

Tipo: _In_ const D3D12_COMMAND_QUEUE_DESC*

Especifica um D3D12_COMMAND_QUEUE_DESC que descreve a fila de comandos.

CreatorID

Tipo: REFIID

Uma ID do criador. Veja os Comentários.

riid

Tipo: REFIID

O GUID (identificador global exclusivo) para a interface da fila de comandos.

ppCommandQueue

Tipo: _COM_Outptr_ void**

Um ponteiro para um bloco de memória que recebe um ponteiro para a interface ID3D12CommandQueue para a fila de comandos.

Retornar valor

Tipo: HRESULT

Retorna E_OUTOFMEMORY se não houver memória suficiente para criar a fila de comandos; caso contrário , S_OK. Confira Códigos de retorno do Direct3D 12 para obter outros valores retornados possíveis.

Comentários

Quando vários componentes no mesmo processo estão compartilhando um único dispositivo Direct3D 12, geralmente eles acabam com cargas de trabalho separadas em filas de comando independentes. Em algumas implementações de hardware, filas independentes podem ser executadas em paralelo apenas com outras filas de comando específicas.

O Direct3D 12 aplica um agrupamento por 1 a 0 para filas, o que pode não funcionar bem para todos os designs de aplicativos ou componentes. Para ajudar a informar o agrupamento de filas do Direct3D 12, você pode especificar uma ID do criador (que é exclusiva por componente) que restringe o agrupamento a outras filas com a mesma ID. Quando possível, um componente deve escolher a mesma ID exclusiva para todas as suas filas. A Microsoft reservou algumas IDs de criador conhecidas para uso por implementações desenvolvidas pela Microsoft de APIs sobre o Direct3D 12.

Requisitos

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

Confira também