DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET funzione di callback (d3dkmddi.h)
La funzione pfnGetPathSourceFromTarget restituisce l'identificatore dell'origine video presente associata a una destinazione di presentazione video specificata.
Sintassi
DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET DxgkddiVidpntopologyGetpathsourcefromtarget;
NTSTATUS DxgkddiVidpntopologyGetpathsourcefromtarget(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidTopology,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] OUT_PD3DDDI_VIDEO_PRESENT_SOURCE_ID pVidPnSourceId
)
{...}
Parametri
[in] hVidTopology
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] VidPnTargetId
Intero che identifica una particolare origine video presente.
[out] pVidPnSourceId
Puntatore a una variabile che riceve l'identificatore dell'origine video presente.
Valore restituito
La funzione pfnGetPathSourceFromTarget 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_INVALID_PARAMETER | Il puntatore fornito in pVidPnSourceId era valido. |
Osservazioni
Una topologia è un percorso di raccolta, ognuno dei quali contiene una coppia (origine, destinazione). Una destinazione specifica appartiene al massimo un percorso, quindi, dato un ID di destinazione, è presente al massimo un'origine associata a tale destinazione.
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 D3DDDI_VIDEO_PRESENT_TARGET_ID sono definiti in D3dukmdt.h.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| piattaforma di destinazione | Desktop |
| intestazione | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |