Partager via


DXGKDDI_VIDPN_GETTOPOLOGY fonction de rappel (d3dkmddi.h)

La fonction pfnGetTopology retourne un handle à l’objet de topologie VidPN contenu par un objet VidPN spécifié.

Syntaxe

DXGKDDI_VIDPN_GETTOPOLOGY DxgkddiVidpnGettopology;

NTSTATUS DxgkddiVidpnGettopology(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [out] OUT_PD3DKMDT_HVIDPNTOPOLOGY phVidPnTopology,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTOPOLOGY_INTERFACE ppVidPnTopologyInterface
)
{...}

Paramètres

[in] hVidPn

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

[out] phVidPnTopology

Pointeur vers une variable qui reçoit un handle vers l’objet de topologie VidPN.

[out] ppVidPnTopologyInterface

Pointeur vers une variable qui reçoit un pointeur vers une structure DXGK_VIDPNTOPOLOGY_INTERFACE . La structure contient des pointeurs vers des fonctions que le pilote de miniport d’affichage peut appeler pour inspecter et modifier l’objet de topologie VidPN.

Valeur retournée

La fonction pfnGetTopology retourne l’une des valeurs suivantes :

Code de retour Description
STATUS_SUCCESS La fonction a réussi.
STATUS_GRAPHICS_INVALID_VIDPN Le handle fourni dans hVidPn n’était pas valide.

Remarques

Le pilote miniport d’affichage n’a pas besoin de libérer le handle qu’il reçoit dans phVidPnTopology.

La durée de vie de la structure DXGK_VIDPNTOPOLOGY_INTERFACE retournée dans ppVidPnTopologyInterface appartient au système d’exploitation. À l’aide de ce schéma de propriété, le système d’exploitation peut migrer vers des implémentations plus récentes au moment de l’exécution sans casser les clients de l’interface.

Configuration requise

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

Voir aussi

DXGK_VIDPNTOPOLOGY_INTERFACE

Interface de topologie VidPN