DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET回呼函式 （d3dkmddi.h）
pfnGetPathSourceFromTarget 函式會傳回與指定視訊簡報目標相關聯的視訊簡訊簡訊標識碼。
語法
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
)
{...}
參數
[in] hVidTopology
VidPN 拓撲物件的句柄。 顯示迷你埠驅動程式先前已呼叫 DXGK_VIDPN_INTERFACE 介面的 pfnGetTopology 函式，以取得此句柄。
[in] VidPnTargetId
識別特定影片呈現來源的整數。
[out] pVidPnSourceId
接收影片呈現來源標識碼之變數的指標。
傳回值
pfnGetPathSourceFromTarget 函式會傳回下列其中一個值：
| 傳回碼 | 描述 |
|---|---|
| STATUS_SUCCESS | 函式成功。 |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | hVidPnTopology 中提供的句柄無效。 |
| STATUS_INVALID_PARAMETER | pVidPnSourceId 中提供的指標有效。 |
言論
拓撲是集合路徑，每個路徑都包含一對（來源、目標）。 特定目標最多屬於一個路徑，因此指定目標標識符時，最多會有一個與該目標相關聯的來源。
作系統會指派 VidPN 來源標識碼。 顯示迷你埠驅動程式所實作的 DxgkDdiStartDevice會傳回顯示配接器所支援之視訊簡訊簡訊的數目 N。 然後作系統會指派識別碼 0、1、2、 ...N - 1.
顯示迷你埠驅動程式會指派 VidPN 目標識別碼。 DxgkDdiQueryChildRelations，由 display miniport 驅動程式實作，會傳回 DXGK_CHILD_DESCRIPTOR 結構的陣列，每個結構都包含標識符。
D3DKMDT_HVIDPNTOPOLOGY數據類型定義於 D3dkmdt.h中。
D3DDDI_VIDEO_PRESENT_SOURCE_ID D3DDDI_VIDEO_PRESENT_TARGET_ID數據類型定義於 D3dukmdt.h中。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 目標平臺 | 桌面 |
| 標頭 | d3dkmddi.h （包括 D3dkmddi.h） |
| IRQL | PASSIVE_LEVEL |