Partager via


DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO fonction de rappel (d3dkmddi.h)

La structure pfnAcquireFirstPathInfo retourne un descripteur du premier chemin d’accès d’un objet de topologie VidPN spécifié.

Syntaxe

DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO DxgkddiVidpntopologyAcquirefirstpathinfo;

NTSTATUS DxgkddiVidpntopologyAcquirefirstpathinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppFirstVidPnPresentPathInfo
)
{...}

Paramètres

[in] hVidPnTopology

Handle d’un objet de topologie VidPN. Le pilote miniport d’affichage a précédemment obtenu ce handle en appelant la fonction pfnGetTopology de l’interface DXGK_VIDPN_INTERFACE .

[out] ppFirstVidPnPresentPathInfo

Pointeur vers une variable qui reçoit un pointeur vers une structure D3DKMDT_VIDPN_PRESENT_PATH . La structure contient diverses informations sur le chemin d’accès, y compris les identificateurs source et cible du chemin d’accès.

Valeur retournée

La fonction pfnAcquireFirstPathInfo retourne l’une des valeurs suivantes :

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

Remarques

Une fois que vous avez terminé d’utiliser la structure D3DKMDT_VIDPN_PRESENT_PATH, vous devez libérer la structure en appelant pfnReleasePathInfo.

Vous pouvez énumérer tous les chemins d’accès qui appartiennent à un objet de topologie VidPN en appelant pfnAcquireFirstPathInfo , puis en effectuant une séquence d’appels à pfnAcquireNextPathInfo.

Le type de données D3DKMDT_HVIDPNTOPOLOGY est défini dans D3dkmdt.h.

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

D3DKMDT_VIDPN_PRESENT_PATH

pfnAcqirePathInfo

pfnAcquireNextPathInfo

pfnReleasePathInfo