DXGKDDI_VIDPNTOPOLOGY_ADDPATH funzione di callback (d3dkmddi.h)

Articolo
02/06/2025

La funzione pfnAddPath aggiunge un percorso video presente a un oggetto topologia VidPN specificato.

Sintassi

DXGKDDI_VIDPNTOPOLOGY_ADDPATH DxgkddiVidpntopologyAddpath;

NTSTATUS DxgkddiVidpntopologyAddpath(
  [in] IN_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in] IN_PD3DKMDT_VIDPN_PRESENT_PATH pVidPnPresentPath
)
{...}

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] pVidPnPresentPath

Puntatore a una struttura D3DKMDT_VIDPN_PRESENT_PATH che descrive il percorso. Il driver miniport di visualizzazione precedentemente ottenuto questo puntatore chiamando pfnCreateNewPathInfo.

Valore restituito

La funzione pfnAddPath 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_ACCESS_DENIED	Il percorso non può essere rimosso nel contesto della chiamata DDI corrente.

Osservazioni

Per aggiungere un percorso a una topologia, il driver miniport di visualizzazione esegue i passaggi seguenti.

Chiamare pfnCreateNewPathInfo per ottenere un puntatore a una struttura D3DKMDT_VIDPN_PRESENT_PATH allocata dal gestore VidPN.

Popolare la struttura D3DKMDT_VIDPN_PRESENT_PATH con informazioni sul percorso, inclusi gli identificatori di origine e destinazione presenti nel video.

Chiamare pfnAddPath per aggiungere il percorso a una topologia.

Il gestore VidPN alloca una struttura di D3DKMDT_VIDPN_PRESENT_PATH quando si chiama pfnCreateNewPathInfo. Se si aggiunge il percorso descritto da tale struttura a una topologia, non è necessario rilasciare in modo esplicito la struttura; pfnAddPath la rilascia.

Se si ottiene una struttura D3DKMDT_VIDPN_PRESENT_PATH chiamando pfnCreateNewPathInfo e quindi si decide di non aggiungere tale percorso a una topologia, è necessario rilasciare in modo esplicito la struttura chiamando pfnReleasePathInfo.

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