ID3D12Device4::CreateCommandList1-Methode (d3d12.h)

  • Artikel

Erstellt eine Befehlsliste im geschlossenen Zustand. Siehe auch ID3D12Device::CreateCommandList.

Syntax

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

Parameter

[in] nodeMask

Typ: UINT

Legen Sie beim Einzel-GPU-Vorgang dies auf Null fest. Wenn mehrere GPU-Knoten vorhanden sind, legen Sie ein Bit fest, um den Knoten (den physischen Adapter des Geräts) zu identifizieren, für den die Befehlsliste erstellt werden soll. Jedes Bit in der Maske entspricht einem einzelnen Knoten. Es muss nur ein Bit festgelegt werden. Weitere Informationen finden Sie unter Multi-Adapter-Systeme.

[in] type

Typ: D3D12_COMMAND_LIST_TYPE

Gibt den Typ der zu erstellenden Befehlsliste an.

flags

Typ: D3D12_COMMAND_LIST_FLAGS

Gibt Erstellungsflags an.

[in] riid

Typ: REFIID

Ein Verweis auf den Globally Unique Identifier (GUID) der Befehlslistenschnittstelle, die in ppCommandList zurückgegeben werden soll.

[out] ppCommandList

Typ: void**

Ein Zeiger auf einen Speicherblock, der einen Zeiger auf die ID3D12CommandList - oder ID3D12GraphicsCommandList-Schnittstelle für die Befehlsliste empfängt.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabewert BESCHREIBUNG
E_OUTOFMEMORY Es ist nicht genügend Arbeitsspeicher vorhanden, um die Befehlsliste zu erstellen.

Weitere mögliche Rückgabewerte finden Sie unter Direct3D 12-Rückgabecodes .

Anforderungen

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

Weitere Informationen

ID3D12Device::CreateCommandList