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 返回以下值之一：
| 返回代码 | 说明 |
|---|---|
| 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 |