DXGKDDI_VIDPN_RELEASETARGETMODESET fonction de rappel (d3dkmddi.h)
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 |