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 |