DXGKDDI_VIDPNTOPOLOGY_RELEASEPATHINFO fonction de rappel (d3dkmddi.h)

Article
02/06/2025

La fonction pfnReleasePathInfo libère une structure D3DKMDT_VIDPN_PRESENT_PATH que le gestionnaire VidPN a précédemment fourni au pilote 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 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 la structure D3DKMDT_VIDPN_PRESENT_PATH à libérer.

Valeur de retour

La fonction pfnReleasePathInfo 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.
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 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 transmettez cette structure à pfnAddPath, vous n’avez pas besoin de libérer la structure.

Si vous obtenez un handle en appelant pfnCreateNewPathInfo, puis que vous décidez de ne pas ajouter le nouveau chemin à 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 .