DXGKDDI_VIDPN_RELEASETARGETMODESET fonction de rappel (d3dkmddi.h)
La fonction pfnReleaseTargetModeSet libère un handle sur 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 ce handle au pilote miniport d’affichage en appelant DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn, ou DxgkDdiRecommendFunctionalVidPn.
[in] hVidPnTargetModeSet
Handle à libérer.
Valeur de retour
La fonction pfnReleaseTargetModeSet retourne l’une des valeurs suivantes :
| Retourner le code | 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
Lorsque 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 passez ce handle à pfnAssignTargetModeSet, vous n’avez pas besoin de libérer le handle.
Si vous obtenez un handle en appelant pfnCreateNewTargetModeSet, puis 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| plateforme cible | Bureau |
| d’en-tête | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |