DXGKDDI_VIDPN_RELEASETARGETMODESET fonction de rappel (d3dkmddi.h)

  • Article

La fonction pfnReleaseTargetModeSet libère un handle pour un objet défini en mode cible.

Syntaxe

DXGKDDI_VIDPN_RELEASETARGETMODESET DxgkddiVidpnReleasetargetmodeset;

NTSTATUS DxgkddiVidpnReleasetargetmodeset(
  [in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet
)
{...}

Paramètres

[in] hVidPn

Handle vers un objet VidPN qui contient l’objet défini en mode cible. Le gestionnaire VidPN a précédemment fourni cette poignée au pilote de miniport d’affichage en appelant DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn ou DxgkDdiRecommendFunctionalVidPn.

[in] hVidPnTargetModeSet

Handle à libérer.

Valeur retournée

La fonction pfnReleaseTargetModeSet retourne l’une des valeurs suivantes :

Code de retour Description
STATUS_SUCCESS La fonction a réussi.
STATUS_GRAPHICS_INVALID_VIDPN Le handle fourni dans hVidPn n’était pas valide.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET Le handle fourni dans hVidPnTargetModeSet n’était pas valide.
STATUS_GRAPHICS_RESOURCES_NOT_RELATED Le VidPN identifié par hVidPn ne contient pas le mode cible défini par hVidPnTargetModeSet.

Remarques

Une fois que vous avez terminé d’utiliser un handle que vous avez obtenu en appelant pfnAcquireTargetModeSet, vous devez libérer le handle en appelant pfnReleaseTargetModeSet.

Si vous obtenez un handle en appelant pfnCreateNewTargetModeSet , puis que vous passez ce handle à pfnAssignTargetModeSet, vous n’avez pas besoin de libérer le handle.

Si vous obtenez un handle en appelant pfnCreateNewTargetModeSet et que vous décidez de ne pas affecter le nouveau mode source défini à une source, vous devez libérer le handle nouvellement obtenu en appelant pfnReleaseTargetModeSet.

Les types de données D3DKMDT_HVIDPN et D3DKMDT_HVIDPNTARGETMODESET sont définis 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

Voir aussi

pfnAcquireTargetModeSet

pfnCreateNewTargetModeSet