ID3D12Device5::CreateMetaCommand-Methode (d3d12.h)

  • Artikel

Erstellt eine instance des angegebenen Metabefehls.

Syntax

HRESULT CreateMetaCommand(
  [in]           REFGUID    CommandId,
  [in]           UINT       NodeMask,
  [in, optional] const void *pCreationParametersData,
  [in]           SIZE_T     CreationParametersDataSizeInBytes,
                 REFIID     riid,
  [out]          void       **ppMetaCommand
);

Parameter

[in] CommandId

Typ: REFIID

Ein Verweis auf den globally unique Identifier (GUID) des Metabefehls, den Sie instanziieren möchten.

[in] NodeMask

Typ: UINT

Legen Sie für den Einzeladaptervorgang diesen Wert auf 0 fest. Wenn mehrere Adapterknoten vorhanden sind, legen Sie ein Bit fest, um den Knoten (einen der physischen Adapter des Geräts) zu identifizieren, auf den der Metabefehl angewendet wird. Jedes Bit in der Maske entspricht einem einzelnen Knoten. Es muss nur ein Bit festgelegt werden. Weitere Informationen finden Sie unter Systeme mit mehreren Adaptern.

[in, optional] pCreationParametersData

Typ: const void*

Ein optionaler Zeiger auf eine konstante Struktur, die die Werte der Parameter zum Erstellen des Metabefehls enthält.

[in] CreationParametersDataSizeInBytes

Typ: SIZE_T

Eine SIZE_T , die die Größe der Struktur enthält, auf die pCreationParametersData verweist, falls festgelegt, andernfalls 0.

riid

Typ: REFIID

Ein Verweis auf den Globally Unique Identifier (GUID) der Schnittstelle, die in ppMetaCommand zurückgegeben werden soll. Hierbei handelt es sich voraussichtlich um die GUID von ID3D12MetaCommand.

[out] ppMetaCommand

Typ: void**

Ein Zeiger auf einen Speicherblock, der einen Zeiger auf den Metabefehl empfängt. Dies ist die Adresse eines Zeigers auf einen ID3D12MetaCommand, der den erstellten Metabefehl darstellt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Rückgabewert BESCHREIBUNG
DXGI_ERROR_UNSUPPORTED
 Die aktuelle Hardware unterstützt den angeforderten Algorithmus nicht.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile d3d12.h

Weitere Informationen

ID3D12Device5