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 函式會傳回下列其中一個值：
| 傳回碼 | 描述 |
|---|---|
| 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 （包括 D3dkmddi.h） |
| IRQL | PASSIVE_LEVEL |