IDXGIAdapter::CheckInterfaceSupport-Methode (dxgi.h)

Artikel
08/23/2023

Überprüft, ob das System eine Geräteschnittstelle für eine Grafikkomponente unterstützt.

Syntax

HRESULT CheckInterfaceSupport(
  [in]  REFGUID       InterfaceName,
  [out] LARGE_INTEGER *pUMDVersion
);

Parameter

[in] InterfaceName

Typ: REFGUID

Die GUID der Schnittstelle der Geräteversion, für die die Unterstützung überprüft wird. Dies sollte in der Regel __uuidof(IDXGIDevice) sein, der die Versionsnummer der Direct3D 9-UMD-Binärdatei (Benutzermodustreiber) zurückgibt. Seit WDDM 2.3 müssen alle Treiberkomponenten innerhalb eines Treiberpakets (D3D9, D3D11 und D3D12) eine einzelne Versionsnummer gemeinsam nutzen. Dies ist daher eine gute Möglichkeit, die Treiberversion unabhängig von der verwendeten API abzufragen.

[out] pUMDVersion

Typ: LARGE_INTEGER*

Die Benutzermodustreiberversion von InterfaceName. Dies wird nur zurückgegeben, wenn die Schnittstelle unterstützt wird, andernfalls ist dieser Parameter NULL.

Rückgabewert

Typ: HRESULT

S_OK gibt an, dass die Schnittstelle unterstützt wird, andernfalls wird DXGI_ERROR_UNSUPPORTED zurückgegeben (weitere Informationen finden Sie unter DXGI_ERROR).

Hinweise

Hinweis Sie können CheckInterfaceSupport nur verwenden, um zu überprüfen, ob eine Direct3D 10.x-Schnittstelle unterstützt wird, und zwar nur unter Windows Vista SP1 und höheren Versionen des Betriebssystems. Wenn Sie versuchen, CheckInterfaceSupport zu verwenden, um zu überprüfen, ob eine Direct3D 11.x-Schnittstelle und eine höhere Version unterstützt wird, gibt CheckInterfaceSupport DXGI_ERROR_UNSUPPORTED zurück. Verwenden Sie daher nicht CheckInterfaceSupport. Versuchen Sie stattdessen, die Schnittstelle zu erstellen, um zu überprüfen, ob das Betriebssystem eine bestimmte Schnittstelle unterstützt. Wenn Sie beispielsweise die ID3D11Device::CreateBlendState-Methode aufrufen und sie fehlschlägt, unterstützt das Betriebssystem die ID3D11BlendState-Schnittstelle nicht.

Anforderungen


Zielplattform	Windows
Kopfzeile	dxgi.h
Bibliothek	DXGI.lib

Weitere Informationen

DXGI-Schnittstellen

IDXGIAdapter

Freigeben über