DXGKDDI_RECOMMENDFUNCTIONALVIDPN回呼函式 (d3dkmddi.h)

DxgkDdiRecommendFunctionalVidPn 函式會建立可在指定顯示配接器上實作的功能 VidPN。

語法

DXGKDDI_RECOMMENDFUNCTIONALVIDPN DxgkddiRecommendfunctionalvidpn;

NTSTATUS DxgkddiRecommendfunctionalvidpn(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_RECOMMENDFUNCTIONALVIDPN_CONST pRecommendFunctionalVidPn
)
{...}

參數

[in] hAdapter

與顯示配接器相關聯的內容區塊句柄。 顯示迷你埠驅動程式先前已將此句柄提供給 DxgkDdiAddDevice 函式之 MiniportDeviceContext 輸出參數中的 DirectX 圖形核心子系統。

[in] pRecommendFunctionalVidPn

包含函式自變數之 DXGKARG_RECOMMENDFUNCTIONALVIDPN 結構的指標。 呼叫端會提供 hRecommendedFunctionalVidPn 成員，這是空 VidPN 物件的句柄。 DxgkDdiRecommendFunctionalVidPn 會將功能 VidPN 的專案填入 VidPN 物件：拓撲、模式集、釘選模式。

傳回值

DxgkDdiRecommendFunctionalVidPn 會傳回下列其中一個值：

傳回碼	Description
STATUS_SUCCESS	函式成功建立功能 VidPN。
STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN	函式無法建立功能性 VidPN。
STATUS_NO_MEMORY	函式失敗，因為它無法配置記憶體。

備註

如果 VidPN 符合下列條件，VidPN 會正常運作：

• 它具有至少一個路徑的拓撲。 (路徑是來源與 target.) 之間的關聯
• 拓撲中的每個來源和目標都有固定模式。

DxgkDdiRecommendFunctionalVidPn 的工作是建立可在顯示配接器上實作的功能 VidPN。 下列清單提供用來建立功能性 VidPN 的步驟。

1. 從空 VidPN 物件的句柄開始。 此句柄是在 pRecommendFunctionalVidPnArg 的 hDesiredVidPn 成員中提供。
2. 將路徑 (來源目標組) 新增至 VidPN 的拓撲。
3. 建立新的來源模式集，並將一個來源模式新增至集合。 將來源模式設定為路徑中的來源。 釘選來源模式。
4. 建立新的目標模式集，並將一個目標模式新增至集合。 將目標模式設定為路徑中的目標。 釘選目標模式。

如需如何新增路徑、新增模式集、指派模式和釘選模式的詳細資訊，請參閱 VidPN 對象和介面。

DxgkDdiRecommendFunctionalVidPn 應設為可分頁。

規格需求

需求	值
最低支援的用戶端	Windows Vista
目標平台	桌面
標頭	d3dkmddi.h
IRQL	PASSIVE_LEVEL