DXGKDDI_RECOMMENDVIDPNTOPOLOGY回呼函式 (d3dkmddi.h)
DxgkDdiRecommendVidPnTopology 函式會建立指定 VidPN 的拓撲，或使用影片呈現目標的新路徑來增強拓撲。
語法
DXGKDDI_RECOMMENDVIDPNTOPOLOGY DxgkddiRecommendvidpntopology;
NTSTATUS DxgkddiRecommendvidpntopology(
IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_RECOMMENDVIDPNTOPOLOGY_CONST pRecommendVidPnTopology
)
{...}
參數
hAdapter
與顯示配接器相關聯的內容區塊句柄。 顯示迷你埠驅動程式先前已將此句柄提供給 DxgkDdiAddDevice 函式之 MiniportDeviceContext 輸出參數中的 Microsoft DirectX 圖形核心子系統。
[in] pRecommendVidPnTopology
包含 函式自變數之DXGKARG_RECOMMENDVIDPNTOPOLOGY 結構的指標。
傳回值
DxgkDdiRecommendVidPnTopology 會傳回下列其中一個值：
| 傳回碼 | Description |
|---|---|
| STATUS_SUCCESS | 函式已成功建立或增強拓撲。 |
| STATUS_GRAPHICS_NO_RECOMMENDED_VIDPN_TOPOLOGY | 函式對於指定 VidPN 拓撲的擴增沒有建議。 |
| STATUS_GRAPHICS_CANCEL_VIDPN_TOPOLOGY_AUGMENTATION | 函式建議取消指定來源上指定 VidPN 拓撲的擴增。 只有在 VidPN 拓撲擴增的情況下，才允許此傳回碼。 |
| STATUS_NO_MEMORY | 函式失敗，因為它無法配置足夠的記憶體。 |
迷你埠驅動程式應該通過它從其沒有後援程式代碼路徑的操作系統取得的任何錯誤碼。
備註
DxgkDdiRecommendVidPnTopology 應設為可分頁。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 目標平台 | 桌面 |
| 標頭 | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |