DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO funzione di callback (d3dkmddi.h)

Articolo
02/06/2025

La funzione pfnAcquirePathInfo restituisce un descrittore del percorso del video presente specificato da un'origine video presente e da una destinazione video presente all'interno di una particolare topologia VidPN.

Sintassi

DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO DxgkddiVidpntopologyAcquirepathinfo;

NTSTATUS DxgkddiVidpntopologyAcquirepathinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppVidPnPresentPathInfo
)
{...}

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

Intero che identifica un'origine presente in un video.

[in] VidPnTargetId

Intero che identifica una destinazione del video presente.

[out] ppVidPnPresentPathInfo

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

Valore restituito

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

Osservazioni

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

Un percorso contiene una coppia (origine, destinazione) e una topologia è una raccolta di percorsi. Questa funzione restituisce un descrittore per il percorso, in una topologia specificata, che contiene una coppia specificata (origine, destinazione).

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

Gli identificatori di origine VidPN vengono assegnati dal sistema operativo. DxgkDdiStartDevice, implementato dal driver miniport di visualizzazione, restituisce il numero N di origini video presenti supportate dalla scheda di visualizzazione. Il sistema operativo assegna quindi gli identificatori 0, 1, 2, ... N - 1.

Gli identificatori di destinazione VidPN vengono assegnati dal driver miniport di visualizzazione. DxgkDdiQueryChildRelations, implementato dal driver miniport di visualizzazione, restituisce una matrice di strutture DXGK_CHILD_DESCRIPTOR, ognuna delle quali contiene un identificatore.

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

I tipi di dati D3DDDI_VIDEO_PRESENT_SOURCE_ID e D3DDDI_VIDEO_PRESENT_TARGET_ID sono definiti in D3dukmdt.h.