DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO funzione di callback (d3dkmddi.h)
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.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista |
Piattaforma di destinazione | Desktop |
Intestazione | d3dkmddi.h (include D3dkmddi.h) |
IRQL | PASSIVE_LEVEL |