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 函式會傳回下列其中一個值：
| 傳回碼 | Description |
|---|---|
| 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 會傳回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 (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |