DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET funzione di callback (d3dkmddi.h)
La funzione pfnGetPathSourceFromTarget restituisce l'identificatore dell'origine video presente associata a una destinazione del 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 visualizzato ottenuto in precedenza questo handle chiamando la funzione pfnGetTo topologia dell'interfaccia DXGK_VIDPN_INTERFACE .
[in] VidPnTargetId
Intero che identifica un'origine video specifica.
[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 | Funzione completata. |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | L'handle fornito in hVidPnTo topologia non è valido. |
| STATUS_INVALID_PARAMETER | Il puntatore fornito in pVidPnSourceId era valido. |
Commenti
Una topologia è un percorso di raccolta, ognuno dei quali contiene una coppia (origine, destinazione). Una determinata destinazione appartiene alla maggior parte di 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 visualizzato, restituisce il numero N di origini video presenti supportate dalla scheda di visualizzazione. Quindi il sistema operativo assegna identificatori 0, 1, 2, ... N - 1.
Gli identificatori di destinazione VidPN vengono assegnati dal driver miniport visualizzato. DxgkDdiQueryChildRelations, implementato dal driver miniport visualizzato, 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Piattaforma di destinazione | Desktop |
| Intestazione | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |