DXGKDDI_VIDPNTOPOLOGY_ENUMPATHTARGETSFROMSOURCE回呼函式 （d3dkmddi.h）
pfnEnumPathTargetsFromSource 函式會傳回與指定視訊簡訊簡訊簡報來源相關聯的其中一個視訊簡訊簡訊標識符。
語法
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
)
{...}
參數
[in] hVidPnTopology
VidPN 拓撲物件的句柄。 顯示迷你埠驅動程式先前已呼叫 DXGK_VIDPN_INTERFACE 介面的 pfnGetTopology 函式，以取得此句柄。
[in] VidPnSourceId
識別特定影片呈現來源的整數。
[in] VidPnPresentPathIndex
VidPnSourceId所識別來源的路徑集合中，以零起始的索引。
[out] pVidPnTargetId
接收目標標識碼之變數的指標。
傳回值
pfnEnumPathTargetsFromSource 函式會傳回下列其中一個值：
| 傳回碼 | 描述 |
|---|---|
| STATUS_SUCCESS | 函式成功。 |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | hVidPnTopology 中提供的句柄無效。 |
| STATUS_INVALID_PARAMETER | pVidPnTargetId 中提供的指標有效。 |
言論
VidPnPresentPathIndex 不是 hVidPnTopology所識別之拓撲中所有路徑的索引。 它是拓撲中所有路徑子集的索引：特別是，包含 VidPnSourceId 所識別來源的所有路徑子集。
若要列舉 （在指定的拓撲中） 與特定來源相關聯的所有目標，請執行下列步驟。
呼叫 pfnGetNumPathsFromSource，以判斷包含感興趣來源的路徑數目 N。 將這些路徑視為索引集，其索引為 0,1,...N - 1.
針對每個索引 0 雖然 N - 1，請將來源標識碼和索引傳遞至 pfnEnumPathTargetsFromSource 。
拓撲是集合路徑，每個路徑都包含一對（來源、目標）。 特定來源可能會出現在多個路徑中。 例如，在複製檢視的情況下，一個來源可以與兩個不同的目標配對。
作系統會指派 VidPN 來源標識碼。 顯示迷你埠驅動程式所實作的 DxgkDdiStartDevice會傳回顯示配接器所支援之視訊簡訊簡訊的數目 N。 然後作系統會指派識別碼 0、1、2、 ...N - 1.
顯示迷你埠驅動程式會指派 VidPN 目標識別碼。 DxgkDdiQueryChildRelations，由 display miniport 驅動程式實作，會傳回 DXGK_CHILD_DESCRIPTOR 結構的陣列，每個結構都包含標識符。
D3DKMDT_HVIDPNTOPOLOGY和D3DKMDT_VIDPN_PRESENT_PATH_INDEX數據類型定義於 D3dkmdt.h中。
D3DDDI_VIDEO_PRESENT_SOURCE_ID和D3DDDI_VIDEO_PRESENT_TARGET_ID數據類型定義於 D3dukmdt.h中。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 目標平臺 | 桌面 |
| 標頭 | d3dkmddi.h （包括 D3dkmddi.h） |
| IRQL | PASSIVE_LEVEL |