ID3D12Device9::CreateCommandQueue1-Methode (d3d12.h)

  • Artikel

Erstellt eine Befehlswarteschlange mit einer Ersteller-ID.

Siehe auch ID3D12Device::CreateCommandQueue.

Syntax

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

Parameter

pDesc

Typ: _In_ const D3D12_COMMAND_QUEUE_DESC*

Gibt einen D3D12_COMMAND_QUEUE_DESC an, der die Befehlswarteschlange beschreibt.

CreatorID

Typ: REFIID

Eine Ersteller-ID. Siehe Hinweise.

riid

Typ: REFIID

Der globally unique Identifier (GUID) für die Befehlswarteschlangenschnittstelle.

ppCommandQueue

Typ: _COM_Outptr_ void**

Ein Zeiger auf einen Speicherblock, der einen Zeiger auf die ID3D12CommandQueue-Schnittstelle für die Befehlswarteschlange empfängt.

Rückgabewert

Typ: HRESULT

Gibt E_OUTOFMEMORY zurück, wenn nicht genügend Arbeitsspeicher zum Erstellen der Befehlswarteschlange vorhanden ist. andernfalls S_OK. Weitere mögliche Rückgabewerte finden Sie unter Direct3D 12-Rückgabecodes .

Hinweise

Wenn mehrere Komponenten im selben Prozess ein einzelnes Direct3D 12-Gerät gemeinsam nutzen, werden sie häufig mit separaten Workloads in unabhängigen Befehlswarteschlangen enden. In einigen Hardwareimplementierungen können unabhängige Warteschlangen nur parallel zu bestimmten anderen Befehlswarteschlangen ausgeführt werden.

Direct3D 12 wendet eine First-Come-First-Serve-Gruppierung für Warteschlangen an, die möglicherweise nicht für alle Anwendungs- oder Komponentendesigns geeignet ist. Um die Gruppierung von Warteschlangen durch Direct3D 12 zu informieren, können Sie eine Ersteller-ID angeben (die pro Komponente eindeutig ist), die die Gruppierung auf andere Warteschlangen mit derselben ID einschränkt. Wenn möglich, sollte eine Komponente die gleiche eindeutige ID für alle zugehörigen Warteschlangen auswählen. Microsoft hat einige bekannte Ersteller-IDs für die Verwendung durch von Microsoft entwickelte Implementierungen von APIs auf Direct3D 12 reserviert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10 Build 20348
Unterstützte Mindestversion (Server) Windows 10 Build 20348
Kopfzeile d3d12.h
Bibliothek d3d12.lib
DLL d3d12.dll

Weitere Informationen