D3D12GetInterface-Funktion (d3d12.h)

Wählt eine SDK-Version zur Laufzeit aus, wenn sich das System im Windows-Entwicklermodus befindet. Unterstützt Debug-, Tools-, DRED- und SDK-Konfigurationsschnittstellen.

Syntax

HRESULT D3D12GetInterface(
  REFCLSID rclsid,
  REFIID   riid,
  void     **ppvDebug
);

Parameter

rclsid

Typ: _In_ REFCLSID

Die CLSID, die den Daten und dem Code zugeordnet ist, die zum Erstellen des Objekts verwendet werden.

Die folgenden CLSIDs werden definiert.

  • DEFINE_GUID(CLSID_D3D12Debug, 0xf2352aeb, 0xdd84, 0x49fe, 0xb9, 0x7b, 0xa9, 0xdc, 0xfd, 0xcc, 0x1b, 0x4f);
  • DEFINE_GUID(CLSID_D3D12Tools, 0xe38216b1, 0x3c8c, 0x4833, 0xaa, 0x09, 0x0a, 0x06, 0xb6, 0x5d, 0x96, 0xc8);
  • DEFINE_GUID(CLSID_D3D12DeviceRemovedExtendedData, 0x4a75bbc4, 0x9ff4, 0x4ad8, 0x9f, 0x18, 0xab, 0xae, 0x84, 0xdc, 0x5f, 0xf2);
  • DEFINE_GUID(CLSID_D3D12SDKConfiguration, 0x7cda6aca, 0xa03e, 0x49c8, 0x94, 0x58, 0x03, 0x34, 0xd2, 0x0e, 0x07, 0xce);

Sie entsprechen den folgenden Schnittstellen.

riid

Typ: _In_ REFIID

Der Globally Unique Identifier (GUID) für die SDK-Konfigurationsschnittstelle. Die REFIID oder GUID der Schnittstelle kann mithilfe des Makros __uuidof abgerufen werden. Ruft beispielsweise __uuidof(ID3D12SDKConfiguration) die GUID der Debugschnittstelle ab.

ppvDebug

Typ: _COM_Outptr_opt_ void**

Der out Parameter, der die angeforderte Schnittstelle bei rückgabe (z. B. die SDK-Konfigurationsschnittstelle) als Zeiger auf void enthält. Siehe ID3D12SDKConfiguration.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird einer der Direct3D 12-Rückgabecodes zurückgegeben.

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