DXGKDDI_VIDPNTOPOLOGY_RELEASEPATHINFO funzione di callback (d3dkmddi.h)

Articolo
02/06/2025

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

Sintassi

DXGKDDI_VIDPNTOPOLOGY_RELEASEPATHINFO DxgkddiVidpntopologyReleasepathinfo;

NTSTATUS DxgkddiVidpntopologyReleasepathinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in] IN_CONST_PD3DKMDT_VIDPN_PRESENT_PATH_CONST pVidPnPresentPathInfo
)
{...}

Parametri

[in] hVidPnTopology

Handle per un oggetto topologia VidPN. Il driver miniport di visualizzazione ottenuto in precedenza questo handle chiamando la funzione pfnGetTopology dell'interfaccia DXGK_VIDPN_INTERFACE.

[in] pVidPnPresentPathInfo

Puntatore alla struttura D3DKMDT_VIDPN_PRESENT_PATH che deve essere rilasciata.

Valore restituito

La funzione pfnReleasePathInfo restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione ha avuto esito positivo.
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY	L'handle fornito in hVidPnTopology non è valido.
STATUS_GRAPHICS_INVALID_VIDPN_PRESENT_PATH	Il puntatore fornito in pVidPnPresentPathInfo non è valido.

Osservazioni

Al termine dell'utilizzo di una struttura D3DKMDT_VIDPN_PRESENT_PATH ottenuta chiamando una delle funzioni seguenti, è necessario rilasciare la struttura chiamando pfnReleasePathInfo.

Se si ottiene una struttura D3DKMDT_VIDPN_PRESENT_PATH chiamando pfnCreateNewPathInfo e quindi passare tale struttura a pfnAddPath, non è necessario rilasciare la struttura.

Se si ottiene un handle chiamando pfnCreateNewPathInfo e quindi si decide di non aggiungere il nuovo percorso a una topologia, è necessario rilasciare la struttura appena creata chiamando pfnReleasePathInfo.

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