DXGKCB_QUERYVIDPNINTERFACE fonction de rappel (d3dkmddi.h)

2025-02-06

DXGKCB_QUERYVIDPNINTERFACE obtient un pointeur vers une structure DXGK_VIDPN_INTERFACE, qui contient des pointeurs vers des fonctions que le pilote 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 vers un objet VidPN. Le gestionnaire VidPN a précédemment fourni le pilote de miniport d’affichage avec ce handle 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 de retour

DxgkCbQueryVidPnInterface retourne l’une des valeurs suivantes :

Retourner le code	Description
STATUS_SUCCESS	La fonction a réussi.
STATUS_INVALID_PARAMETER	La valeur transmise à ppVidPnInterface n’est pas valide.
STATUS_GRAPHICS_INVALID_VIDPN	Le handle passé à hVidPn n’est pas valide.
STATUS_NOT_SUPPORTED	La version de l’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.