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

另請參閱

D3DKMDT_VIDPN_PRESENT_PATH

pfnCreateNewPathInfo

pfnReleasePathInfo