Windows 11下用IDD驱动（IddCx）手搓一个虚拟显示器：从签名到扩展屏的完整踩坑记录

Windows 11下基于IDD框架开发虚拟显示器的实战指南

在Windows 11系统中，微软提供的Indirect Display Driver（IDD）框架为开发者开辟了一条全新的虚拟显示器开发路径。不同于传统的显示驱动开发方式，IDD框架通过用户模式驱动模型大幅降低了开发门槛，让开发者能够更专注于虚拟显示功能的实现而非底层驱动细节。本文将带您从零开始，逐步构建一个功能完整的虚拟显示器解决方案。

1. 开发环境准备与基础概念

在开始IDD开发之前，我们需要先搭建合适的开发环境并理解几个核心概念。Windows驱动开发与传统应用开发有着显著差异，特别是在安全验证和系统集成方面。

1.1 必备工具与SDK安装

首先需要安装以下开发工具：

• Visual Studio 2019或更高版本（需包含C++工作负载）
• Windows 11 WDK（Windows Driver Kit）
• Windows 11 SDK
• WDK扩展包（包含IddCx库支持）

安装完成后，在VS中创建新项目时选择"Kernel Mode Driver, Empty (KMDF)"模板，然后手动添加IddCx支持。项目配置中需要特别注意：

// 示例：IddCx头文件包含 #include <iddcx.h> #pragma comment(lib, "iddcx.lib")

1.2 IDD框架核心组件

IDD架构由三个关键层组成：

1.3 开发模式设置

由于驱动开发涉及系统底层操作，我们需要配置测试签名环境：

1. 生成测试证书：

   makecert -r -pe -ss PrivateCertStore -n CN=TestCert TestCert.cer

2. 启用测试签名模式：

   bcdedit /set testsigning on

注意：测试模式仅用于开发环境，生产环境必须使用正式签名证书。

2. IDD驱动核心对象与初始化流程

IDD框架围绕几个核心对象构建，理解它们的生命周期和交互方式是开发成功的关键。

2.1 驱动入口与设备初始化

驱动入口点DriverEntry中需要完成基本注册：

extern "C" NTSTATUS DriverEntry(PDRIVER_OBJECT pDriverObject, PUNICODE_STRING pRegistryPath) { WDF_DRIVER_CONFIG config; WDF_DRIVER_CONFIG_INIT(&config, IddSampleDeviceAdd); return WdfDriverCreate(pDriverObject, pRegistryPath, WDF_NO_OBJECT_ATTRIBUTES, &config, WDF_NO_HANDLE); }

设备添加回调IddSampleDeviceAdd是初始化的核心：

NTSTATUS IddSampleDeviceAdd(WDFDRIVER Driver, PWDFDEVICE_INIT pDeviceInit) { // 设置电源回调 WDF_PNPPOWER_EVENT_CALLBACKS_INIT(&PnpPowerCallbacks); PnpPowerCallbacks.EvtDeviceD0Entry = IddSampleDeviceD0Entry; WdfDeviceInitSetPnpPowerEventCallbacks(pDeviceInit, &PnpPowerCallbacks); // 配置IDD回调 IDD_CX_CLIENT_CONFIG IddConfig; IDD_CX_CLIENT_CONFIG_INIT(&IddConfig); IddConfig.EvtIddCxAdapterInitFinished = IddSampleAdapterInitFinished; IddConfig.EvtIddCxParseMonitorDescription = IddSampleParseMonitorDescription; // ...其他回调设置 NTSTATUS status = IddCxDeviceInitConfig(pDeviceInit, &IddConfig); if (!NT_SUCCESS(status)) return status; // 创建设备对象 return WdfDeviceCreate(&pDeviceInit, &Attr, &Device); }

2.2 适配器对象创建

适配器对象(IDDCX_ADAPTER)代表虚拟显示适配器，通常在设备进入D0状态时创建：

NTSTATUS IddSampleDeviceD0Entry(WDFDEVICE Device, WDF_POWER_DEVICE_STATE PreviousState) { auto* pContext = WdfObjectGet_IndirectDeviceContextWrapper(Device); IDARG_IN_ADAPTER_INIT initArgs = {}; initArgs.WdfDevice = Device; IDARG_OUT_ADAPTER_INIT outArgs = {}; NTSTATUS status = IddCxAdapterInitAsync(&initArgs, &outArgs); if (NT_SUCCESS(status)) { pContext->pContext->SetAdapter(outArgs.AdapterObject); } return status; }

适配器初始化完成后，系统会调用EvtIddCxAdapterInitFinished回调：

NTSTATUS IddSampleAdapterInitFinished(IDDCX_ADAPTER Adapter, const IDARG_IN_ADAPTER_INIT_FINISHED* pInArgs) { if (NT_SUCCESS(pInArgs->AdapterInitStatus)) { // 初始化成功，创建虚拟显示器 CreateVirtualMonitor(Adapter); } return pInArgs->AdapterInitStatus; }

3. 虚拟显示器实现细节

虚拟显示器的核心在于正确配置显示器属性和处理图像数据流。

3.1 显示器创建与EDID配置

创建显示器时需要提供详细的EDID信息：

void CreateVirtualMonitor(IDDCX_ADAPTER Adapter) { IDDCX_MONITOR_INFO monitorInfo = {}; monitorInfo.Size = sizeof(monitorInfo); monitorInfo.MonitorType = DISPLAYCONFIG_OUTPUT_TECHNOLOGY_HDMI; monitorInfo.ConnectorIndex = 0; // EDID配置 monitorInfo.MonitorDescription.Size = sizeof(monitorInfo.MonitorDescription); monitorInfo.MonitorDescription.Type = IDDCX_MONITOR_DESCRIPTION_TYPE_EDID; monitorInfo.MonitorDescription.DataSize = sizeof(StandardEdid); monitorInfo.MonitorDescription.pData = const_cast<BYTE*>(StandardEdid); // 创建显示器对象 IDARG_IN_MONITORCREATE createArgs = {}; createArgs.pMonitorInfo = &monitorInfo; IDARG_OUT_MONITORCREATE createOut; NTSTATUS status = IddCxMonitorCreate(Adapter, &createArgs, &createOut); if (NT_SUCCESS(status)) { // 通知系统显示器已连接 IDARG_OUT_MONITORARRIVAL arrivalOut; IddCxMonitorArrival(createOut.MonitorObject, &arrivalOut); } }

标准EDID数据结构示例：

static const BYTE StandardEdid[] = { 0x00, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x00, 0x1E, 0x6D, 0x01, 0x00, 0x01, 0x00, 0x00, 0x00, 0x1B, 0x1A, 0x01, 0x03, 0x80, 0x50, 0x2D, 0x78, 0x0A, 0x0D, 0xC9, 0xA0, 0x57, 0x47, 0x98, 0x27, // ...完整的EDID数据 };

3.2 显示模式配置

系统会通过回调查询支持的显示模式：

NTSTATUS IddSampleMonitorQueryModes(IDDCX_MONITOR Monitor, const IDARG_IN_QUERYTARGETMODES* pInArgs, IDARG_OUT_QUERYTARGETMODES* pOutArgs) { // 分配模式列表内存 pOutArgs->pTargetModes = (IDDCX_TARGET_MODE*)CoTaskMemAlloc(sizeof(IDDCX_TARGET_MODE) * SupportedModeCount); pOutArgs->TargetModeCount = SupportedModeCount; // 填充支持的模式 for (UINT i = 0; i < SupportedModeCount; i++) { pOutArgs->pTargetModes[i].Size = sizeof(IDDCX_TARGET_MODE); pOutArgs->pTargetModes[i].VideoSignalInfo = SupportedModes[i]; } return STATUS_SUCCESS; }

常用显示模式定义示例：

static const IDDCX_VIDEO_SIGNAL_INFO SupportedModes[] = { // 1920x1080 @ 60Hz { .Size = sizeof(IDDCX_VIDEO_SIGNAL_INFO), .VideoStandard = D3DKMDT_VSS_OTHER, .TotalSize = {1920, 1080}, .ActiveSize = {1920, 1080}, .VSyncFreq = {60000, 1000}, .PixelRate = 148500000, .ScanLineOrdering = D3DDDI_VSSLO_PROGRESSIVE }, // 2560x1440 @ 60Hz { // ...类似配置 } };

4. 图像处理与交换链管理

虚拟显示器的核心功能是接收并处理系统发送的桌面图像数据。

4.1 交换链分配回调

当系统准备发送图像数据时，会调用交换链分配回调：

NTSTATUS IddSampleMonitorAssignSwapChain(IDDCX_MONITOR Monitor, const IDARG_IN_SETSWAPCHAIN* pInArgs) { auto* pMonitorContext = WdfObjectGet_IndirectMonitorContextWrapper(Monitor); // 保存当前交换链 pMonitorContext->pContext->SetSwapChain(pInArgs->hSwapChain); // 启动处理线程 HANDLE hThread = CreateThread(nullptr, 0, ProcessSwapChainThread, pMonitorContext, 0, nullptr); CloseHandle(hThread); return STATUS_SUCCESS; }

4.2 图像数据处理线程

独立的线程负责从交换链获取并处理图像：

DWORD WINAPI ProcessSwapChainThread(LPVOID lpParameter) { auto* pMonitorContext = (IndirectMonitorContextWrapper*)lpParameter; while (true) { IDARG_IN_RELEASESWAPCHAIN releaseArgs = {}; IDARG_OUT_RELEASESWAPCHAIN releaseOut = {}; // 从交换链获取表面 IDARG_IN_ACQUIRESWAPCHAINBUFFER acquireArgs = {}; IDARG_OUT_ACQUIRESWAPCHAINBUFFER acquireOut = {}; NTSTATUS status = IddCxSwapChainAcquireBuffer(pMonitorContext->pContext->GetSwapChain(), &acquireArgs, &acquireOut); if (!NT_SUCCESS(status)) break; // 处理图像数据 ProcessFrame(acquireOut.pSurfaceData, acquireOut.MetaData); // 释放表面 IddCxSwapChainReleaseBuffer(pMonitorContext->pContext->GetSwapChain(), &releaseArgs, &releaseOut); } return 0; }

4.3 图像处理优化技巧

为提高性能，可以采用以下优化策略：

• 双缓冲机制：维护两个缓冲区交替处理
• DMA支持：利用硬件加速数据传输
• 部分更新：仅处理变化的屏幕区域
• 格式转换预处理：在GPU上完成色彩空间转换

void ProcessFrame(const BYTE* pData, const IDDCX_SWAPCHAIN_METADATA& metaData) { // 根据元数据确定图像参数 UINT width = metaData.Width; UINT height = metaData.Height; DXGI_FORMAT format = metaData.Format; // 实际处理逻辑... if (format == DXGI_FORMAT_B8G8R8A8_UNORM) { ProcessBgraFrame(pData, width, height); } else if (format == DXGI_FORMAT_R16G16B16A16_FLOAT) { ProcessRgba16Frame(pData, width, height); } }

5. 常见问题排查与调试技巧

在IDD开发过程中会遇到各种问题，掌握有效的调试方法至关重要。

5.1 驱动签名问题排查

如果遇到IddCxAdapterInitAsync返回STATUS_NOT_SUPPORTED，通常是由于签名验证失败：

1. 确认测试证书已正确安装：

   certmgr.msc

2. 检查驱动文件签名：

   signtool verify /v /kp YourDriver.sys

3. 确保系统处于测试模式：

   bcdedit /enum | find "testsigning"

5.2 调试输出配置

在驱动中添加调试输出：

NTSTATUS DriverEntry(PDRIVER_OBJECT pDriverObject, PUNICODE_STRING pRegistryPath) { // 注册调试回调 WDF_DRIVER_CONFIG_INIT(&config, IddSampleDeviceAdd); WdfDriverCreate(..., &config, ...); // 设置调试过滤器 WPP_INIT_TRACING(pDriverObject, pRegistryPath); TraceEvents(TRACE_LEVEL_INFORMATION, TRACE_DRIVER, "%!FUNC! Entry"); return STATUS_SUCCESS; }

调试输出查看工具：

• WinDbg（内核调试）
• DebugView（用户模式输出）
• WPP追踪（结构化日志）

5.3 性能优化指标

关键性能指标监控表：

6. 高级功能扩展

基础功能实现后，可以考虑扩展更高级的特性。

6.1 多显示器支持

通过管理多个IDDCX_MONITOR对象实现多显示器：

void CreateMultiMonitors(IDDCX_ADAPTER Adapter, UINT count) { for (UINT i = 0; i < count; i++) { IDDCX_MONITOR_INFO info = {}; info.ConnectorIndex = i; // ...其他配置 IDARG_IN_MONITORCREATE createArgs = {}; createArgs.pMonitorInfo = &info; IDARG_OUT_MONITORCREATE createOut; if (NT_SUCCESS(IddCxMonitorCreate(Adapter, &createArgs, &createOut))) { m_Monitors.push_back(createOut.MonitorObject); } } }

6.2 动态分辨率切换

支持运行时分辨率变更：

1. 实现模式变更回调：

   IddConfig.EvtIddCxAdapterCommitModes = IddSampleAdapterCommitModes;

2. 处理模式变更请求：

   NTSTATUS IddSampleAdapterCommitModes(IDDCX_ADAPTER Adapter, const IDARG_IN_COMMITMODES* pInArgs) { for (UINT i = 0; i < pInArgs->PathCount; i++) { const IDDCX_PATH* pPath = &pInArgs->pPaths[i]; ApplyNewMode(pPath->TargetMode); } return STATUS_SUCCESS; }

6.3 虚拟输入设备集成

将虚拟显示器与输入设备结合：

void SimulateInputForVirtualDisplay(UINT monitorId, INPUT_RECORD input) { // 将输入坐标转换为虚拟显示器坐标系 RECT displayRect = GetDisplayRect(monitorId); input.Event.MouseEvent.dwMousePosition.X += displayRect.left; input.Event.MouseEvent.dwMousePosition.Y += displayRect.top; // 注入输入事件 HANDLE hConsole = GetStdHandle(STD_INPUT_HANDLE); WriteConsoleInput(hConsole, &input, 1, nullptr); }

7. 部署与安装优化

开发完成后，需要确保驱动能够正确安装和运行。

7.1 INF文件配置

完整的INF文件示例：

[Version] Signature="$WINDOWS NT$" Class=Display ClassGuid={4d36e968-e325-11ce-bfc1-08002be10318} Provider=%Manufacturer% DriverVer=01/01/2023,1.0.0.0 [Manufacturer] %Manufacturer%=Standard,NTamd64 [Standard.NTamd64] %DeviceDesc%=DeviceInstall, PCI\VEN_1414&DEV_008C [DeviceInstall] CopyFiles=DriverFiles AddReg=DeviceAddReg [DriverFiles] YourDriver.sys [DeviceAddReg] HKR,, InstalledDisplayDrivers, %REG_MULTI_SZ%, YourDriver HKR,, "UpperFilters", %REG_MULTI_SZ%, "IndirectKmd" [DestinationDirs] DriverFiles=12

7.2 安装验证步骤

1. 使用DPInst安装驱动：

   dpinst.exe /path/to/driver

2. 验证驱动加载：

   devmgmt.msc

3. 检查事件日志：

   eventvwr.msc

7.3 自动安装脚本

PowerShell安装脚本示例：

$driverPath = "C:\Drivers\VirtualDisplay" $infFile = Join-Path $driverPath "YourDriver.inf" # 导入测试证书 $cert = Import-Certificate -FilePath "$driverPath\TestCert.cer" -CertStoreLocation Cert:\LocalMachine\TrustedPublisher # 安装驱动 pnputil /add-driver $infFile /install # 启用设备 Enable-PnpDevice -InstanceId (Get-PnpDevice -FriendlyName "Virtual Display").InstanceId -Confirm:$false

8. 实际应用场景与性能调优

虚拟显示器技术在实际项目中的应用需要结合具体场景进行优化。

8.1 远程办公解决方案

将虚拟显示器技术与远程桌面结合：

1. 架构设计：

   • 服务端：运行虚拟显示器驱动
   • 客户端：接收并显示远程图像
   • 通信协议：优化图像传输（如H.264编码）

2. 性能优化点：

   • 动态码率调整
   • 区域更新检测
   • 输入设备重定向

8.2 多屏工作环境模拟

为单物理显示器设备提供多屏体验：

// 创建环绕式虚拟显示器阵列 void CreateSurroundDisplays(IDDCX_ADAPTER Adapter) { const UINT cols = 3; const UINT rows = 2; for (UINT y = 0; y < rows; y++) { for (UINT x = 0; x < cols; x++) { CreateVirtualDisplay(Adapter, x * 1920, y * 1080, 1920, 1080); } } }

8.3 性能基准测试

建立性能测试体系：

1. 测试指标：

   • 帧率稳定性
   • 输入延迟
   • 多显示器同步性

2. 测试工具：

   LARGE_INTEGER start, end, freq; QueryPerformanceFrequency(&freq); QueryPerformanceCounter(&start); // 测试代码... QueryPerformanceCounter(&end); double elapsed = (end.QuadPart - start.QuadPart) * 1000.0 / freq.QuadPart;

3. 优化对比表：