DXGKDDI_VIDPNSOURCEMODESET_RELEASEMODEINFO fonction de rappel (d3dkmddi.h)

  • Article

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

Syntaxe

DXGKDDI_VIDPNSOURCEMODESET_RELEASEMODEINFO DxgkddiVidpnsourcemodesetReleasemodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetReleasemodeinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in] IN_CONST_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}

Paramètres

[in] hVidPnSourceModeSet

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

[in] pVidPnSourceModeInfo

Pointeur vers la structure D3DKMDT_VIDPN_SOURCE_MODE qui doit être libérée.

Valeur retournée

La fonction pfnReleaseModeInfo retourne l’une des valeurs suivantes :

Code de retour Description
STATUS_SUCCESS La fonction a réussi.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET Le handle fourni dans hVidPnSourceModeSet n’était pas valide.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_SOURCE_MODE Le pointeur fourni dans pVidPnSourceModeInfo n’était pas valide.

Remarques

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

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

Si vous obtenez un handle en appelant pfnCreateNewModeInfo et que vous décidez de ne pas ajouter le nouveau mode à un ensemble de modes source, 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.

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

Voir aussi

D3DKMDT_VIDPN_SOURCE_MODE

pfnAcquireFirstModeInfo

pfnAcquireNextModeInfo

pfnAcquirePinnedModeInfo