Virtual Display Driver：Windows虚拟显示驱动安装与使用指南

1. 项目概述

Virtual Display Driver是一款适用于Windows 10及以上系统的虚拟显示驱动程序，能够为您的计算机添加多个虚拟显示器。该驱动采用Rust语言开发，支持x64架构，可广泛应用于VR、直播软件、远程桌面等多种场景，为用户提供灵活的多显示器扩展解决方案。

1.1 核心功能特性

• 多显示器支持：最多可添加10个虚拟显示器
• 灵活配置选项：每个显示器可设置多种分辨率和刷新率
• 直观管理界面：提供图形化控制面板，支持启用/禁用单个或全部虚拟显示器
• 广泛兼容性：适用于Windows 10 2004+（仅x64架构）

2. 环境准备与前置要求

在开始安装虚拟显示驱动前，请确保您的系统满足以下要求：

• 操作系统：Windows 10 2004或更高版本（仅支持64位系统）
• 管理员权限：安装过程需要管理员权限以完成证书安装和驱动配置
• 硬件要求：支持WDDM 2.7及以上的图形适配器
• 存储空间：至少100MB可用空间

⚠️ 注意：安装前请暂时关闭任何安全软件，以免干扰证书安装和驱动签名验证过程。

3. 驱动安装指南

3.1 证书安装流程

虚拟显示驱动需要数字证书签名才能被Windows系统信任，以下是证书安装步骤：

1. 从项目发布包中提取DriverCertificate.cer和install-cert.bat文件
2. 右键点击install-cert.bat，选择"以管理员身份运行"
3. 在弹出的命令提示符窗口中，按任意键继续证书安装
4. 系统将自动完成证书导入，成功后会显示"成功添加到存储"的提示

手动安装方法（当批处理文件执行失败时）：

certutil -addstore -f root "DriverCertificate.cer"
certutil -addstore -f TrustedPublisher "DriverCertificate.cer"

验证证书安装：

• 按下Win + R，输入certlm.msc打开证书管理器
• 依次检查"受信任的根证书颁发机构"和"受信任的发布者"
• 确认是否存在名为"DriverCertificate"的证书

3.2 标准安装方式（MSI安装程序）

1. 从项目发布包中获取MSI安装文件
2. 双击运行安装程序，用户账户控制提示时点击"是"
3. 在安装向导中点击"下一步"，接受许可协议
4. 选择安装路径（建议使用默认路径）
5. 点击"安装"开始安装过程
6. 安装完成后，勾选"启动Virtual Display Driver Control"
7. 点击"完成"结束安装

安装成功后，系统将自动启动虚拟显示驱动服务，并在开始菜单创建"Virtual Display Driver Control"快捷方式。

3.3 便携版安装方式

便携版适用于需要在多台计算机间移动使用或无法执行标准安装的场景：

1. 解压便携版压缩包到目标文件夹（例如D:\VirtualDisplayDriver）
2. 按照3.1节步骤安装证书
3. 双击运行install.reg文件，确认注册表修改
4. 打开设备管理器，通过以下步骤手动添加硬件：
   • 点击菜单栏"操作" → "添加过时硬件"
   • 选择"安装我手动从列表选择的硬件"
   • 选择"显示所有设备"
   • 点击"从磁盘安装"，浏览到解压文件夹并选择VirtualDisplayDriver.inf
   • 按照向导完成驱动安装

3.4 命令行安装方式（使用nefcon CLI）

nefcon CLI提供了高级驱动管理功能，适用于系统管理员和高级用户：

1. 从项目installer/files目录获取nefconc.exe文件
2. 将其复制到便携版解压文件夹
3. 以管理员身份打开命令提示符，导航到该文件夹
4. 执行以下命令序列安装驱动：

.\nefconc.exe --remove-device-node --hardware-id Root\VirtualDisplayDriver --class-guid "4D36E968-E325-11CE-BFC1-08002BE10318"
.\nefconc.exe --create-device-node --class-name Display --class-guid "4D36E968-E325-11CE-BFC1-08002BE10318" --hardware-id Root\VirtualDisplayDriver
.\nefconc.exe --install-driver --inf-path ".\VirtualDisplayDriver.inf"

仅卸载驱动：

.\nefconc.exe --remove-device-node --hardware-id Root\VirtualDisplayDriver --class-guid "4D36E968-E325-11CE-BFC1-08002BE10318"

4. 基本使用方法

4.1 启动控制面板

成功安装后，可以通过以下方式启动虚拟显示驱动控制面板：

• 开始菜单 → "Virtual Display Driver Control"
• 安装目录中直接运行Virtual Display Driver Control.exe
• 命令行执行Virtual Display Driver Control.exe

4.2 虚拟显示器配置

控制面板主界面提供以下功能：

1. 添加虚拟显示器：

   • 点击"添加显示器"按钮
   • 在弹出窗口中设置显示器参数：
     • 分辨率（如1920×1080、2560×1440等）
     • 刷新率（如60Hz、144Hz等）
     • 显示器名称（可选）
   • 点击"应用"创建虚拟显示器

2. 管理现有显示器：

   • 勾选/取消勾选显示器名称旁的复选框可快速启用/禁用
   • 点击"设置"图标修改分辨率和刷新率
   • 点击"删除"图标移除虚拟显示器
   • 使用"上移"/"下移"按钮调整显示顺序

3. 全局控制：

   • "全部启用"/"全部禁用"按钮控制所有虚拟显示器状态
   • "保存配置"按钮保存当前设置，下次启动自动应用

4.3 高级设置

在控制面板的"设置"标签页中，可配置以下高级选项：

• 显示设置：

  • 自动启动：勾选后系统启动时自动运行驱动服务
  • 显示通知：启用/禁用虚拟显示器状态变化通知
  • 镜像模式：选择是否将主显示器内容镜像到虚拟显示器

• 性能选项：

  • 渲染质量：调整虚拟显示器渲染性能与质量平衡
  • 硬件加速：启用/禁用GPU硬件加速（需支持DirectX 11及以上）
  • 内存优化：设置虚拟显示缓存大小

5. 驱动管理接口

5.1 控制面板API功能

Virtual Display Driver Control提供以下编程接口功能：

• 显示器管理：

  • 添加/删除虚拟显示器
  • 修改显示器分辨率和刷新率
  • 查询当前显示器状态

• 系统集成：

  • 获取显示设备列表
  • 检测物理显示器连接状态
  • 虚拟显示器位置调整

5.2 命令行工具使用

虚拟显示驱动提供命令行管理工具virtual-display-driver-cli，位于安装目录的tools子文件夹下：

基本命令格式：

virtual-display-driver-cli [命令] [参数]

常用命令示例：

1. 列出所有虚拟显示器：

virtual-display-driver-cli list

2. 添加虚拟显示器：

virtual-display-driver-cli add --resolution 1920x1080 --refresh 60 --name "Virtual Monitor 1"

3. 启用/禁用虚拟显示器：

virtual-display-driver-cli enable "Virtual Monitor 1"
virtual-display-driver-cli disable "Virtual Monitor 1"

4. 修改显示器参数：

virtual-display-driver-cli modify "Virtual Monitor 1" --resolution 2560x1440 --refresh 144

5. 删除虚拟显示器：

virtual-display-driver-cli remove "Virtual Monitor 1"

5.3 Python绑定使用

项目提供Python绑定库，位于rust/bindings/python目录，使用方法如下：

1. 安装Python绑定：

cd rust/bindings/python
pip install .

2. Python API示例：

import virtual_display_driver as vdd

# 初始化驱动连接
driver = vdd.DriverClient()

# 获取当前显示器列表
monitors = driver.list_monitors()
print(f"当前虚拟显示器数量: {len(monitors)}")

# 添加新虚拟显示器
new_monitor = driver.add_monitor(
    name="Python Controlled Monitor",
    width=1920,
    height=1080,
    refresh_rate=60
)

# 启用虚拟显示器
driver.enable_monitor(new_monitor.id)

# 修改分辨率
driver.set_resolution(new_monitor.id, 2560, 1440, 144)

6. 故障排除与日志查看

6.1 常见问题解决

问题1：安装驱动时提示"此驱动不受信任"

• 确保已按照3.1节正确安装证书
• 检查证书是否在有效期内
• 尝试手动安装证书到"受信任的根证书颁发机构"

问题2：虚拟显示器创建后不显示

• 打开Windows显示设置，检查是否检测到虚拟显示器
• 点击"检测"按钮刷新显示设备列表
• 调整虚拟显示器位置，确保未超出屏幕边界

问题3：控制面板无法启动

• 检查驱动服务是否运行：sc query vdd-user-session-service
• 如服务未运行，执行：sc start vdd-user-session-service
• 检查系统日志中的错误信息

6.2 查看驱动日志

虚拟显示驱动日志记录在Windows事件查看器中：

1. 按下Win + R，输入eventvwr.msc打开事件查看器
2. 导航到"Windows日志" → "应用程序"
3. 在右侧筛选栏中，事件来源选择"VirtualDisplayDriver"

创建自定义视图以便快速查看：

• 右键点击"自定义视图" → "创建自定义视图"
• 选择"按来源"，勾选"VirtualDisplayDriver"
• 点击"确定"，输入名称"Virtual Display Driver日志"
• 之后可在"自定义视图"下直接访问该日志

6.3 驱动卸载方法

标准卸载：

1. 打开"控制面板" → "程序和功能"
2. 找到"Virtual Display Driver"
3. 右键选择"卸载"，按照向导完成卸载

命令行卸载：

nefconc.exe --remove-device-node --hardware-id Root\VirtualDisplayDriver --class-guid "4D36E968-E325-11CE-BFC1-08002BE10318"

完全清理残留文件：

1. 删除安装目录（默认为C:\Program Files\Virtual Display Driver）
2. 删除用户配置文件：%APPDATA%\Virtual Display Driver
3. 重启计算机

7. 开发与构建指南

7.1 环境准备

构建虚拟显示驱动需要以下开发环境：

• Windows 10/11 64位系统
• Visual Studio 2022（安装"桌面开发与C++"工作负载）
• Windows驱动工具包(WDK) 10.0.22000.0及以上
• Rust工具链（1.56.0及以上）
• Cargo-make和Cargo-target-dir工具

安装命令：

cargo install cargo-make
cargo install cargo-target-dir

7.2 构建步骤

1. 克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/vi/virtual-display-rs
cd virtual-display-rs

2. 构建调试版本：

cargo make build

3. 构建发布版本：

cargo make -p prod build

构建输出文件位于target/output目录下，包含驱动文件、控制面板应用和相关工具。

4. 构建安装程序（需要WiX Toolset）：

cargo make build-installer

8. 注意事项与限制

⚠️ 重要安全注意事项：

• 仅从官方渠道获取驱动文件，避免安装篡改版本
• 定期更新驱动以获取安全补丁和功能改进
• 证书安装仅需执行一次，多次安装不会影响系统安全性

⚠️ 功能限制：

• 最多支持同时创建10个虚拟显示器
• 虚拟显示器不支持硬件加速视频解码
• 远程桌面会话中可能无法使用某些高级功能
• 部分全屏应用可能无法正确识别虚拟显示器

9. 故障报告与支持

如遇到驱动问题，请收集以下信息后提交故障报告：

1. 事件查看器中的"VirtualDisplayDriver"日志
2. 系统信息报告（运行msinfo32并保存为NFO文件）
3. 问题复现步骤和预期行为描述
4. 虚拟显示驱动版本和Windows系统版本

您可以通过项目的讨论区或社区渠道获取技术支持和提交反馈。