DXGKDDI_VIDPN_RELEASETARGETMODESET funzione di callback (d3dkmddi.h)

  • Articolo

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

Vedi anche

pfnAcquireTargetModeSet

pfnCreateNewTargetModeSet