Condividi tramite

Metodo ID3D12Device9::CreateCommandQueue1 (d3d12.h)

  • Articolo

Crea una coda di comandi con un ID autore.

Vedi anche ID3D12Device::CreateCommandQueue.

Sintassi

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

Parametri

pDesc

Tipo: _In_ const D3D12_COMMAND_QUEUE_DESC*

Specifica un D3D12_COMMAND_QUEUE_DESC che descrive la coda dei comandi.

CreatorID

Tipo: REFIID

ID autore. Vedere la sezione Osservazioni.

riid

Tipo: REFIID

Identificatore univoco globale (GUID) per l'interfaccia della coda dei comandi.

ppCommandQueue

Tipo: _COM_Outptr_ void**

Puntatore a un blocco di memoria che riceve un puntatore all'interfaccia ID3D12CommandQueue per la coda di comandi.

Valore restituito

Tipo: HRESULT

Restituisce E_OUTOFMEMORY se la memoria non è sufficiente per creare la coda dei comandi; in caso contrario , S_OK. Per altri possibili valori restituiti, vedere Codici restituiti Direct3D 12 .

Commenti

Quando più componenti nello stesso processo condividono un singolo dispositivo Direct3D 12, spesso finiscono con carichi di lavoro separati in code di comandi indipendenti. In alcune implementazioni hardware, le code indipendenti possono essere eseguite in parallelo solo con altre code di comandi specifiche.

Direct3D 12 applica un raggruppamento first-come first-serve per le code, che potrebbe non funzionare correttamente per tutte le progettazioni di applicazioni o componenti. Per informare il raggruppamento di code di Direct3D 12, è possibile specificare un ID creatore (univoco per componente) che limita il raggruppamento ad altre code con lo stesso ID. Quando possibile, un componente deve scegliere lo stesso ID univoco per tutte le code. Microsoft ha riservato alcuni ID creator noti per l'uso da parte di implementazioni sviluppate da Microsoft di API oltre a Direct3D 12.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 Build 20348
Server minimo supportato Windows 10 Build 20348
Intestazione d3d12.h
Libreria d3d12.lib
DLL d3d12.dll

Vedi anche