DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO fonction de rappel (d3dkmddi.h)
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, compte tenu du chemin 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 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 .
[in] pVidPnPresentPathInfo
Pointeur vers une structure D3DKMDT_VIDPN_PRESENT_PATH qui décrit le chemin d’accès actuel. Le pilote miniport d’affichage a précédemment obtenu 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 d’accès suivant.
Valeur retournée
La fonction pfnAcquireNextPathInfo 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 |