DXGKDDI_VIDPNTOPOLOGY_RELEASEPATHINFO fonction de rappel (d3dkmddi.h)
La fonction pfnReleasePathInfo libère une structure D3DKMDT_VIDPN_PRESENT_PATH que le gestionnaire VidPN a précédemment fournie au pilote de miniport d’affichage.
Syntaxe
DXGKDDI_VIDPNTOPOLOGY_RELEASEPATHINFO DxgkddiVidpntopologyReleasepathinfo;
NTSTATUS DxgkddiVidpntopologyReleasepathinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_CONST_PD3DKMDT_VIDPN_PRESENT_PATH_CONST pVidPnPresentPathInfo
)
{...}
Paramètres
[in] hVidPnTopology
Handle pour un objet de topologie VidPN. Le pilote de 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 la structure D3DKMDT_VIDPN_PRESENT_PATH qui doit être libérée.
Valeur retournée
La fonction pfnReleasePathInfo 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. |
| STATUS_GRAPHICS_INVALID_VIDPN_PRESENT_PATH | Le pointeur fourni dans pVidPnPresentPathInfo n’était pas valide. |
Remarques
Lorsque vous avez terminé d’utiliser une structure D3DKMDT_VIDPN_PRESENT_PATH que vous avez obtenue en appelant l’une des fonctions suivantes, vous devez libérer la structure en appelant pfnReleasePathInfo.
Si vous obtenez une structure D3DKMDT_VIDPN_PRESENT_PATH en appelant pfnCreateNewPathInfo , puis que vous passez cette structure à pfnAddPath, vous n’avez pas besoin de libérer la structure.Si vous obtenez un handle en appelant pfnCreateNewPathInfo et que vous décidez de ne pas ajouter le nouveau chemin d’accès à une topologie, vous devez libérer la structure nouvellement créée en appelant pfnReleasePathInfo.
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 (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |