DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO fonction de rappel (d3dkmddi.h)

Article
02/06/2025

La fonction pfnAcquireNextPathInfo retourne un descripteur du chemin d’accès présent de la vidéo suivante dans une topologie VidPN spécifiée, en fonction du chemin d’accès actuel.

Syntaxe

DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO DxgkddiVidpntopologyAcquirenextpathinfo;

NTSTATUS DxgkddiVidpntopologyAcquirenextpathinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in]  IN_CONST_PD3DKMDT_VIDPN_PRESENT_PATH_CONST pVidPnPresentPathInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppNextVidPnPresentPathInfo
)
{...}

Paramètres

[in] hVidPnTopology

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

[in] pVidPnPresentPathInfo

Pointeur vers une structure D3DKMDT_VIDPN_PRESENT_PATH qui décrit le chemin d’accès actuel. Le pilote de miniport d’affichage obtenu précédemment ce pointeur en appelant pfnAcquireFirstPathInfo ou pfnAcquireNextPathInfo.

[out] ppNextVidPnPresentPathInfo

Pointeur vers une variable qui reçoit un pointeur vers une structure D3DKMDT_VIDPN_PRESENT_PATH qui décrit le chemin suivant.

Valeur de retour

La fonction pfnAcquireNextPathInfo retourne l’une des valeurs suivantes :

Retourner le code	Description
STATUS_SUCCESS	La fonction a réussi.
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY	Le handle fourni dans hVidPnTopology n’était pas valide.

Remarques

Lorsque 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 appartenant à 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 .