DXGKDDI_VIDPNTARGETMODESET_RELEASEMODEINFO funzione di callback (d3dkmddi.h)

Articolo
02/25/2024

La funzione pfnReleaseModeInfo rilascia una struttura D3DKMDT_VIDPN_TARGET_MODE fornita in precedenza dal gestore VidPN al driver miniport di visualizzazione.

Sintassi

DXGKDDI_VIDPNTARGETMODESET_RELEASEMODEINFO DxgkddiVidpntargetmodesetReleasemodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetReleasemodeinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_CONST_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo
)
{...}

Parametri

[in] hVidPnTargetModeSet

Handle per un oggetto set di modalità di destinazione VidPN. Il driver miniport di visualizzazione ottenuto in precedenza questo handle chiamando la funzione pfnAcquireTargetModeSet dell'interfaccia DXGK_VIDPN_INTERFACE .

[in] pVidPnTargetModeInfo

Puntatore alla struttura D3DKMDT_VIDPN_TARGET_MODE da rilasciare.

Valore restituito

La funzione pfnReleaseModeInfo restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Funzione completata.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	L'handle fornito in hVidPnTargetModeSet non è valido.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET_MODE	Il puntatore fornito in pVidPnTargetModeInfo non è valido.

Commenti

Al termine dell'uso di una struttura D3DKMDT_VIDPN_TARGET_MODE ottenuta chiamando una delle funzioni seguenti, è necessario rilasciare la struttura chiamando pfnReleaseModeInfo.

Se si ottiene una struttura D3DKMDT_VIDPN_TARGET_MODE chiamando pfnCreateNewModeInfo e quindi passando tale struttura a pfnAddMode, non è necessario rilasciare la struttura.

Se si ottiene un handle chiamando pfnCreateNewModeInfo e quindi si decide di non aggiungere la nuova modalità a un set di modalità di destinazione, è necessario rilasciare la struttura appena creata chiamando pfnReleaseModeInfo.

Il tipo di dati D3DKMDT_HVIDPNSOURCEMODESET è definito in D3dkmdt.h.