DXGKCB_QUERYVIDPNINTERFACE Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

DXGKCB_QUERYVIDPNINTERFACE ruft einen Zeiger auf eine DXGK_VIDPN_INTERFACE-Struktur ab, die Zeiger auf Funktionen enthält, die der Anzeigeminiporttreiber aufrufen kann, um ein VidPN-Objekt zu prü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 zu einem VidPN-Objekt. Der VidPN-Manager stellte zuvor den Display-Miniporttreiber mit diesem Handle bereit, indem DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPnoder DxgkDdiRecommendFunctionalVidPn.

[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_V1festlegen.

[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 war erfolgreich.
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.

Bemerkungen

DXGKCB_XXX Funktionen werden von Dxgkrnlimplementiert. Um diese Rückruffunktion zu verwenden, ruft der Kernelmodustreiber DxgkCbQueryVidPnInterface über die DXGKRNL_INTERFACEauf.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista (WDDM 1.0)
Zielplattform-	Desktop
Header-	d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL-	<= APC_LEVEL