DXGKDDI_VIDPNTOPOLOGY_ADDPATH funzione di callback (d3dkmddi.h)

Articolo
03/30/2024

La funzione pfnAddPath aggiunge un percorso di presentazione video 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 visualizzato ottenuto in precedenza questo handle chiamando la funzione pfnGetTo topologia dell'interfaccia DXGK_VIDPN_INTERFACE .

[in] pVidPnPresentPath

Puntatore a una struttura D3DKMDT_VIDPN_PRESENT_PATH che descrive il percorso. Il driver miniport visualizzato ha ottenuto in precedenza questo puntatore chiamando pfnCreateNewPathInfo.

Valore restituito

La funzione pfnAddPath restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Funzione completata.
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY	L'handle fornito in hVidPnTo topologia non è valido.
STATUS_ACCESS_DENIED	Impossibile rimuovere il percorso nel contesto della chiamata DDI corrente.

Commenti

Per aggiungere un percorso a una topologia, il driver miniport visualizzato esegue la procedura seguente.

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

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

Chiamare pfnAddPath per aggiungere il percorso a una topologia.

Il manager VidPN alloca una struttura 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 decidere 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.