Windows多屏显示驱动开发与故障排查 - 第2节

2.1 WDDM 与 KMD 概述

Windows 显示驱动模型（WDDM，Windows Display Driver Model）是 Windows Vista 及之后版本引入的图形驱动架构，取代了旧的 XPDM。WDDM 的核心设计目标包括：多任务 GPU 虚拟化、故障隔离、跨会话支持以及多屏扩展。内核模式驱动（KMD）是 WDDM 中运行在操作系统内核态的驱动组件，直接与 GPU 硬件交互。

2.1.1 WDDM 版本与多屏支持演进

2.1.2 WDDM 驱动栈整体架构

WDDM 驱动栈采用分层设计，从用户态到内核态再到硬件，每一层都有明确的职责边界。下图展示了驱动栈的核心组件及其交互关系：

2.2 UMD 与 KMD 的分工

用户模式驱动（UMD）和内核模式驱动（KMD）在 WDDM 架构中承担截然不同的职责。理解两者的分工边界，是定位多屏扩展故障的前提。

2.2.1 职责对比

2.2.2 多屏扩展场景下的交互流程

当用户通过 Win+P 或系统设置扩展桌面时，UMD 和 KMD 按以下步骤协同工作：

1. 应用层发起请求： 用户模式下的 Desktop Window Manager (DWM) 调用 IDXGIFactory::CreateSwapChain 创建新的交换链。
2. UMD 构建命令： UMD 将 DWM 的 Present 调用转换为 GPU 可执行的命令缓冲区，并附加 VidPnSourceId 标识目标显示器。
3. DXGKRNL 路由： 内核态的 DXGKRNL 收到命令缓冲区后，调用 DxgkDdiSubmitCommand 将命令传递给对应的 GPU Miniport。
4. KMD 执行模式切换： GPU Miniport 调用 DxgkDdiCommitVidPn 更新显示路径，配置时钟、时序和输出端口。
5. 硬件生效： 显示控制器根据新的 VidPn 设置驱动显示器，完成扩展。

2.3 驱动栈：DXGKRNL / GPU Miniport

驱动栈的核心是 DXGKRNL (DirectX Graphics Kernel) 和 GPU Miniport 之间的协作。DXGKRNL 是微软提供的通用图形内核模块，而 GPU Miniport 是 GPU 厂商（Intel、AMD、NVIDIA）实现的硬件抽象层。

2.3.1 DXGKRNL 的职责

• 显示路径管理： 维护 VidPn (Video Present Network) 拓扑，管理显示源与显示目标的连接关系。
• GPU 调度： 管理 GPU 上下文、DMA 缓冲区队列和硬件引擎的时分复用。
• 内存管理： 通过 VidMm (Video Memory Manager) 分配和回收显存，支持分页和驻留。
• 故障恢复： 检测 GPU 超时（TDR，Timeout Detection and Recovery），触发驱动重置。

2.3.2 GPU Miniport 的职责

• 硬件抽象： 封装 GPU 寄存器操作、DMA 引擎控制和显示控制器配置。
• 中断处理： 响应 GPU 中断（VSync、DMA 完成、错误），并回调 DXGKRNL 通知事件。
• 显示模式设置： 实现 DxgkDdiSetVidPnSourceAddress 和 DxgkDdiSetVidPnSourceVisibility 等 DDI 函数。
• 电源管理： 配合 DXGKRNL 实现运行时 D3 电源状态切换。

2.3.3 关键 DDI 函数调用链

以下代码展示了多屏扩展场景下，DXGKRNL 调用 GPU Miniport 的典型 DDI 序列：

// DXGKRNL 发起 VidPn 提交
NTSTATUS DxgkDdiCommitVidPn(
    IN_CONST_HANDLE hAdapter,
    IN_CONST_PDXGKARG_COMMITVIDPN pCommitVidPn
)
{
    // 1. 验证 VidPn 拓扑合法性
    // 2. 配置显示控制器时钟和时序
    // 3. 设置帧缓冲地址（每个显示源独立）
    for (UINT i = 0; i < pCommitVidPn->PathCount; i++)
    {
        DXGKARG_SETVIDPNSOURCEADDRESS setAddr = {0};
        setAddr.VidPnSourceId = pCommitVidPn->pPaths[i].VidPnSourceId;
        setAddr.PrimaryAddress = pCommitVidPn->pPaths[i].PrimarySegment;
        DxgkDdiSetVidPnSourceAddress(hAdapter, &setAddr);
    }
    // 4. 使能输出端口
    return STATUS_SUCCESS;
}

2.3.4 驱动栈故障隔离矩阵