DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO funzione di callback (d3dkmddi.h)

Articolo
02/23/2024

La funzione pfnAcquireNextPathInfo restituisce un descrittore del percorso del video successivo presente in una topologia VidPN specificata, in base al percorso corrente.

Sintassi

DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO DxgkddiVidpntopologyAcquirenextpathinfo;

NTSTATUS DxgkddiVidpntopologyAcquirenextpathinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in]  IN_CONST_PD3DKMDT_VIDPN_PRESENT_PATH_CONST pVidPnPresentPathInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppNextVidPnPresentPathInfo
)
{...}

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

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

[out] ppNextVidPnPresentPathInfo

Puntatore a una variabile che riceve un puntatore a una struttura D3DKMDT_VIDPN_PRESENT_PATH che descrive il percorso successivo.

Valore restituito

La funzione pfnAcquireNextPathInfo 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.

Commenti

Al termine dell'uso della struttura D3DKMDT_VIDPN_PRESENT_PATH, è necessario rilasciare la struttura chiamando pfnReleasePathInfo.

È possibile enumerare tutti i percorsi appartenenti a un oggetto topologia VidPN chiamando pfnAcquireFirstPathInfo e quindi eseguendo una sequenza di chiamate a pfnAcquireNextPathInfo.

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