DXGKDDI_VIDPN_RELEASETARGETMODESET funzione di callback (d3dkmddi.h)
La funzione pfnReleaseTargetModeSet rilascia un handle a un oggetto set di 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 a un oggetto VidPN contenente l'oggetto set di modalità di destinazione. Il manager VidPN in precedenza ha fornito questo handle al driver miniport visualizzato chiamando DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn o DxgkDdiRecommendFunctionalVidPn.
[in] hVidPnTargetModeSet
Handle da rilasciare.
Valore restituito
La funzione pfnReleaseTargetModeSet restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | Funzione completata. |
| 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 | VidPN identificato da hVidPn non contiene il set di modalità di destinazione identificato da hVidPnTargetModeSet. |
Commenti
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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Piattaforma di destinazione | Desktop |
| Intestazione | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |