D3D12GetDebugInterface-Funktion (d3d12.h)

Ruft eine Debugschnittstelle ab.

Verwenden Sie D3D12GetInterface , um direkt auf neuere Schnittstellen zuzugreifen, insbesondere auf Downlevel.

Syntax

HRESULT D3D12GetDebugInterface(
  [in]            REFIID riid,
  [out, optional] void   **ppvDebug
);

Parameter

[in] riid

Typ: REFIID

Der globally unique Identifier (GUID) für die Debugschnittstelle. Die REFIID oder GUID der Debugschnittstelle kann mithilfe des Makros __uuidof() abgerufen werden. Beispielsweise ruft __uuidof(ID3D12Debug) die GUID der Debugschnittstelle ab.

[out, optional] ppvDebug

Typ: void**

Die Debugschnittstelle als Zeiger auf den Zeiger auf void. Siehe ID3D12Debug und ID3D12DebugDevice.

Rückgabewert

Typ: HRESULT

Diese Methode gibt einen der Direct3D 12-Rückgabecodes zurück.

Hinweise

Die Funktionssignatur PFN_D3D12_GET_DEBUG_INTERFACE wird als Typedef bereitgestellt, sodass Sie dynamische Verknüpfungstechniken (GetProcAddress) anstelle von statisch verknüpfen können.

Beispiele

Aktivieren Sie die D3D12-Debugebene.

// Enable the D3D12 debug layer.
{
    
    ComPtr<ID3D12Debug> debugController;
    if (SUCCEEDED(D3D12GetDebugInterface(IID_PPV_ARGS(&debugController))))
    {
        debugController->EnableDebugLayer();
    }
}

Weitere Informationen finden Sie im Beispielcode in der D3D12-Referenz.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile d3d12.h
Bibliothek D3D12.lib
DLL D3D12.dll

Weitere Informationen

Kernfunktionen