DXGKDDI_RECOMMENDVIDPNTOPOLOGY回调函数 （d3dkmddi.h）
DxgkDdiRecommendVidPnTopology 函数创建指定 VidPN 的拓扑，或使用视频演示目标的新路径扩充拓扑。
语法
DXGKDDI_RECOMMENDVIDPNTOPOLOGY DxgkddiRecommendvidpntopology;
NTSTATUS DxgkddiRecommendvidpntopology(
IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_RECOMMENDVIDPNTOPOLOGY_CONST pRecommendVidPnTopology
)
{...}
参数
hAdapter
与显示适配器关联的上下文块的句柄。 显示微型端口驱动程序以前向 MiniportDeviceContext 中的 Microsoft DirectX 图形内核子系统提供了此句柄，DxgkDdiAddDevice 函数的输出参数。
[in] pRecommendVidPnTopology
指向包含函数参数的 DXGKARG_RECOMMENDVIDPNTOPOLOGY 结构的指针。
返回值
DxgkDdiRecommendVidPnTopology 返回以下值之一：
| 返回代码 | 描述 |
|---|---|
| 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 |