DXGKCB_QUERYVIDPNINTERFACE fonction de rappel (d3dkmddi.h)

Article
02/26/2024

DXGKCB_QUERYVIDPNINTERFACE obtient un pointeur vers une structure DXGK_VIDPN_INTERFACE , qui contient des pointeurs vers des fonctions que le pilote de miniport d’affichage peut appeler pour inspecter et modifier un objet VidPN.

Syntaxe

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
)
{...}

Paramètres

[in] hVidPn

Handle d’un objet VidPN. Le gestionnaire VidPN a précédemment fourni au pilote d’affichage miniport cette poignée en appelant DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn ou DxgkDdiRecommendFunctionalVidPn.

[in] VidPnInterfaceVersion

Énumérateur DXGK_VIDPN_INTERFACE_VERSION qui spécifie la version de l’interface VidPN demandée. Les appelants doivent définir ce paramètre sur DXGK_VIDPN_INTERFACE_VERSION_V1.

[out] ppVidPnInterface

Pointeur vers une variable qui reçoit un pointeur vers la structure DXGK_VIDPN_INTERFACE .

Valeur retournée

DxgkCbQueryVidPnInterface retourne l’une des valeurs suivantes :

Code de retour	Description
STATUS_SUCCESS	La fonction a réussi.
STATUS_INVALID_PARAMETER	La valeur passée à ppVidPnInterface n’est pas valide.
STATUS_GRAPHICS_INVALID_VIDPN	Le handle passé à hVidPn n’est pas valide.
STATUS_NOT_SUPPORTED	La version d’interface spécifiée par VidPnInterfaceVersion n’est pas prise en charge.

Remarques

DXGKCB_XXX fonctions sont implémentées par Dxgkrnl. Pour utiliser cette fonction de rappel, le pilote en mode noyau appelle DxgkCbQueryVidPnInterface via le DXGKRNL_INTERFACE.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista (WDDM 1.0)
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3dkmddi.h (inclure D3dkmddi.h)
IRQL	<= APC_LEVEL