DXGKDDI_VIDPNSOURCEMODESET_RELEASEMODEINFO funzione di callback (d3dkmddi.h)

Articolo
02/23/2024

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

Sintassi

DXGKDDI_VIDPNSOURCEMODESET_RELEASEMODEINFO DxgkddiVidpnsourcemodesetReleasemodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetReleasemodeinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in] IN_CONST_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}

Parametri

[in] hVidPnSourceModeSet

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

[in] pVidPnSourceModeInfo

Puntatore alla struttura D3DKMDT_VIDPN_SOURCE_MODE da rilasciare.

Valore restituito

La funzione pfnReleaseModeInfo restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Funzione completata.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET	L'handle fornito in hVidPnSourceModeSet non è valido.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_SOURCE_MODE	Il puntatore fornito in pVidPnSourceModeInfo non è valido.

Commenti

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

Se si ottiene una struttura D3DKMDT_VIDPN_SOURCE_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 origine, è necessario rilasciare la struttura appena creata chiamando pfnReleaseModeInfo.

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