DXGKDDI_VIDPN_RELEASETARGETMODESET funzione di callback (d3dkmddi.h)
La funzione pfnReleaseTargetModeSet rilascia un handle a un oggetto set in modalità di destinazione.
Sintassi
DXGKDDI_VIDPN_RELEASETARGETMODESET DxgkddiVidpnReleasetargetmodeset;
NTSTATUS DxgkddiVidpnReleasetargetmodeset(
[in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
[in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet
)
{...}
Parametri
[in] hVidPn
Handle per un oggetto VidPN che contiene l'oggetto set di modalità di destinazione. Il manager VidPN ha precedentemente fornito questo handle al driver miniport di visualizzazione chiamando DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPno DxgkDdiRecommendFunctionalVidPn.
[in] hVidPnTargetModeSet
Handle da rilasciare.
Valore restituito
La funzione pfnReleaseTargetModeSet restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | La funzione ha avuto esito positivo. |
| STATUS_GRAPHICS_INVALID_VIDPN | L'handle fornito in hVidPn non è valido. |
| STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET | L'handle fornito in hVidPnTargetModeSet non è valido. |
| STATUS_GRAPHICS_RESOURCES_NOT_RELATED | Il VidPN identificato da hVidPn non contiene il set di modalità di destinazione identificato da hVidPnTargetModeSet. |
Osservazioni
Al termine dell'uso di un handle ottenuto chiamando pfnAcquireTargetModeSet, è necessario rilasciare l'handle chiamando pfnReleaseTargetModeSet.
Se si ottiene un handle chiamando pfnCreateNewTargetModeSet e quindi passare tale handle a pfnAssignTargetModeSet, non è necessario rilasciare l'handle.
Se si ottiene un handle chiamando pfnCreateNewTargetModeSet e quindi si decide di non assegnare la nuova modalità di origine impostata su un'origine, è necessario rilasciare l'handle appena ottenuto chiamando pfnReleaseTargetModeSet.
I tipi di dati D3DKMDT_HVIDPN e D3DKMDT_HVIDPNTARGETMODESET sono definiti in D3dkmdt.h.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| piattaforma di destinazione | Desktop |
| intestazione | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |