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 函式會傳回下列其中一個值:
傳回碼 | Description |
---|---|
STATUS_SUCCESS | 此函數已成功。 |
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | hVidPnTopology 中提供的句柄無效。 |
STATUS_INVALID_PARAMETER | pVidPnSourceId 中提供的指標有效。 |
備註
拓撲是集合路徑,每個路徑都包含 (來源、目標) 組。 特定目標最多屬於一個路徑,因此假設目標標識符最多有一個與該目標相關聯的來源。
操作系統會指派 VidPN 來源標識碼。 由顯示迷你埠驅動程序實作的 DxgkDdiStartDevice 會傳回顯示配接器所支援的視訊簡訊簡報來源數目 N。 然後作業系統會指派識別碼 0、1、2、...N - 1.
顯示迷你埠驅動程式會指派 VidPN 目標識別碼。 由顯示迷你埠驅動程序實作的 DxgkDdiQueryChildRelations 會傳回DXGK_CHILD_DESCRIPTOR結構的數位,每個結構都包含標識碼。
D3DKMDT_HVIDPNTOPOLOGY數據類型定義於 D3dkmdt.h 中。
D3DDDI_VIDEO_PRESENT_SOURCE_ID D3DDDI_VIDEO_PRESENT_TARGET_ID數據類型定義於 D3dukmdt.h 中。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
目標平台 | 桌面 |
標頭 | d3dkmddi.h (include D3dkmddi.h) |
IRQL | PASSIVE_LEVEL |