DXGKDDI_VIDPNTOPOLOGY_ADDPATH回呼函式 (d3dkmddi.h)
pfnAddPath 函式會將影片呈現路徑新增至指定的 VidPN 拓撲物件。
語法
DXGKDDI_VIDPNTOPOLOGY_ADDPATH DxgkddiVidpntopologyAddpath;
NTSTATUS DxgkddiVidpntopologyAddpath(
[in] IN_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_PD3DKMDT_VIDPN_PRESENT_PATH pVidPnPresentPath
)
{...}
參數
[in] hVidPnTopology
VidPN 拓撲物件的句柄。 顯示迷你埠驅動程式先前透過呼叫 DXGK_VIDPN_INTERFACE 介面的 pfnGetTopology 函式來取得此句柄。
[in] pVidPnPresentPath
描述路徑之D3DKMDT_VIDPN_PRESENT_PATH結構的指標。 顯示迷你埠驅動程式先前藉由呼叫 pfnCreateNewPathInfo 來取得此指標。
傳回值
pfnAddPath 函式會傳回下列其中一個值：
| 傳回碼 | Description |
|---|---|
| STATUS_SUCCESS | 此函數已成功。 |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | hVidPnTopology 中提供的句柄無效。 |
| STATUS_ACCESS_DENIED | 目前 DDI 呼叫的內容中無法移除路徑。 |
備註
若要將路徑新增至拓撲，顯示迷你埠驅動程式會執行下列步驟。
呼叫 pfnCreateNewPathInfo 以取得 VidPN 管理員所配置 之D3DKMDT_VIDPN_PRESENT_PATH 結構的指標。
使用路徑的相關信息填入D3DKMDT_VIDPN_PRESENT_PATH結構，包括視訊呈現來源和目標標識符。
呼叫 pfnAddPath 以將路徑新增至拓撲。
當您呼叫 pfnCreateNewPathInfo 時，VidPN 管理員會配置D3DKMDT_VIDPN_PRESENT_PATH結構。 如果您將該結構描述的路徑新增至拓撲，則不需要明確釋放結構; pfnAddPath 會釋放它。
如果您藉由呼叫 pfnCreateNewPathInfo 取得D3DKMDT_VIDPN_PRESENT_PATH結構，然後決定不要將該路徑新增至拓撲，則您必須呼叫 pfnReleasePathInfo 明確地釋放結構。
D3DKMDT_HVIDPNTOPOLOGY數據類型定義於 D3dkmdt.h 中。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 目標平台 | 桌面 |
| 標頭 | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |