DXGKDDI_VIDPNTOPOLOGY_ENUMPATHTARGETSFROMSOURCE funzione di callback (d3dkmddi.h)

La funzione pfnEnumPathTargetsFromSource restituisce l'identificatore di una delle destinazioni del video presenti associate a un'origine video specificata.

Sintassi

DXGKDDI_VIDPNTOPOLOGY_ENUMPATHTARGETSFROMSOURCE DxgkddiVidpntopologyEnumpathtargetsfromsource;

NTSTATUS DxgkddiVidpntopologyEnumpathtargetsfromsource(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [in]  IN_CONST_D3DKMDT_VIDPN_PRESENT_PATH_INDEX VidPnPresentPathIndex,
  [out] OUT_PD3DDDI_VIDEO_PRESENT_TARGET_ID pVidPnTargetId
)
{...}

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 una determinata origine video.

[in] VidPnPresentPathIndex

Indice in base zero nel set di percorsi che contengono l'origine identificata da VidPnSourceId.

[out] pVidPnTargetId

Puntatore a una variabile che riceve l'identificatore di destinazione.

Valore restituito

La funzione pfnEnumPathTargetsFromSource restituisce uno dei valori seguenti:

Commenti

VidPnPresentPathIndex non è un indice nel set di tutti i percorsi nella topologia identificata da hVidPnTopology. Si tratta di un indice in un subset di tutti i percorsi nella topologia: in particolare, il subset di tutti i percorsi che contengono l'origine identificata da VidPnSourceId.

Per enumerare (in una determinata topologia) tutte le destinazioni associate a una determinata origine, seguire questa procedura.

Chiamare pfnGetNumPathsFromSource per determinare il numero N di percorsi che contengono l'origine di interesse. Si pensi a questi percorsi come un set indicizzato con indici 0, 1, ... N - 1.

Per ogni indice 0 tramite N - 1, passare l'identificatore di origine e l'indice a pfnEnumPathTargetsFromSource.

Una topologia è un percorso di raccolta, ognuno dei quali contiene una coppia (origine, destinazione). È possibile che una determinata origine venga visualizzata in più di un percorso. Ad esempio, un'origine può essere associata a due destinazioni distinte nel caso di una vista clone.

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.

I tipi di dati D3DKMDT_HVIDPNTOPOLOGY e D3DKMDT_VIDPN_PRESENT_PATH_INDEX sono definiti in D3dkmdt.h.

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

Requisiti

Vedi anche

pfnGetNumPathsFromSource

pfnGetPathSourceFromTarget