DXGKCB_QUERYVIDPNINTERFACE Rückruffunktion (d3dkmddi.h)

Artikel
02/23/2024

DXGKCB_QUERYVIDPNINTERFACE ruft einen Zeiger auf eine DXGK_VIDPN_INTERFACE-Struktur ab, die Zeiger auf Funktionen enthält, die der Anzeige-Miniporttreiber aufrufen kann, um ein VidPN-Objekt zu überprüfen und zu ändern.

Syntax

DXGKCB_QUERYVIDPNINTERFACE DxgkcbQueryvidpninterface;

NTSTATUS DxgkcbQueryvidpninterface(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_DXGK_VIDPN_INTERFACE_VERSION VidPnInterfaceVersion,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPN_INTERFACE ppVidPnInterface
)
{...}

Parameter

[in] hVidPn

Ein Handle für ein VidPN-Objekt. Der VidPN-Manager hat zuvor den Anzeigeminiporttreiber mit diesem Handle bereitgestellt, indem er DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn oder DxgkDdiRecommendFunctionalVidPn aufgerufen hat.

[in] VidPnInterfaceVersion

Ein DXGK_VIDPN_INTERFACE_VERSION Enumerator, der die Version der angeforderten VidPN-Schnittstelle angibt. Aufrufer müssen diesen Parameter auf DXGK_VIDPN_INTERFACE_VERSION_V1 festlegen.

[out] ppVidPnInterface

Ein Zeiger auf eine Variable, die einen Zeiger auf die DXGK_VIDPN_INTERFACE-Struktur empfängt.

Rückgabewert

DxgkCbQueryVidPnInterface gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion wurde erfolgreich ausgeführt.
STATUS_INVALID_PARAMETER	Der an ppVidPnInterface übergebene Wert ist ungültig.
STATUS_GRAPHICS_INVALID_VIDPN	Das an hVidPn übergebene Handle ist ungültig.
STATUS_NOT_SUPPORTED	Die von VidPnInterfaceVersion angegebene Schnittstellenversion wird nicht unterstützt.

Hinweise

DXGKCB_XXX Funktionen werden von Dxgkrnl implementiert. Um diese Rückruffunktion zu verwenden, ruft der Kernelmodustreiber DxgkCbQueryVidPnInterface über die DXGKRNL_INTERFACE auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista (WDDM 1.0)
Zielplattform	Desktop
Kopfzeile	d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL	<= APC_LEVEL