DXGKDDI_VIDPNTARGETMODESET_RELEASEMODEINFO fonction de rappel (d3dkmddi.h)

Article
02/06/2025

La fonction pfnReleaseModeInfo libère une structure D3DKMDT_VIDPN_TARGET_MODE que le gestionnaire VidPN a précédemment fourni au pilote miniport d’affichage.

Syntaxe

DXGKDDI_VIDPNTARGETMODESET_RELEASEMODEINFO DxgkddiVidpntargetmodesetReleasemodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetReleasemodeinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_CONST_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo
)
{...}

Paramètres

[in] hVidPnTargetModeSet

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

[in] pVidPnTargetModeInfo

Pointeur vers la structure D3DKMDT_VIDPN_TARGET_MODE à libérer.

Valeur de retour

La fonction pfnReleaseModeInfo retourne l’une des valeurs suivantes :

Retourner le code	Description
STATUS_SUCCESS	La fonction a réussi.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	Le handle fourni dans hVidPnTargetModeSet n’était pas valide.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET_MODE	Le pointeur fourni dans pVidPnTargetModeInfo n’était pas valide.

Remarques

Une fois que vous avez terminé d’utiliser une structure D3DKMDT_VIDPN_TARGET_MODE obtenue en appelant l’une des fonctions suivantes, vous devez libérer la structure en appelant pfnReleaseModeInfo.

Si vous obtenez une structure D3DKMDT_VIDPN_TARGET_MODE en appelant pfnCreateNewModeInfo, puis passez cette structure à pfnAddMode, vous n’avez pas besoin de libérer la structure.

Si vous obtenez un handle en appelant pfnCreateNewModeInfo, puis que vous décidez de ne pas ajouter le nouveau mode à un jeu de mode cible, vous devez libérer la structure nouvellement créée en appelant pfnReleaseModeInfo.

Le type de données D3DKMDT_HVIDPNSOURCEMODESET est défini dans D3dkmdt.h.