ViGEmBus 游戏控制器模拟驱动完全指南

一、项目概述

ViGEmBus 是一款运行在 Windows 内核模式的驱动程序，专门用于模拟知名的 USB 游戏控制器。该项目采用 Microsoft 的 Kernel-Mode Driver Framework 开发，能够 100% 准确地模拟真实游戏外设，无需修改游戏代码即可实现即插即用。

重要提示：根据项目 README 文件，ViGEmBus 项目已经宣布退役，用户被鼓励阅读项目生命周期结束声明。

二、核心功能与支持设备

2.1 支持的设备类型

ViGEmBus 支持模拟以下两种主流游戏控制器：

设备类型	技术名称	模拟精度	适用场景
Xbox 360 控制器	Xusb	高精度模拟	大部分Xbox/PC游戏
DualShock 4 控制器	Ds4	高精度模拟	PS4游戏及模拟器

2.2 典型应用场景

• 使用不支持的输入设备在游戏中运行
• 在 PS4 Remote Play 中使用自定义控制器
• 解决 x360ce 不兼容的游戏问题
• 通过网络扩展输入设备范围
• 游戏测试和输入重放机制
• 解决 XInput 玩家槽位分配问题

三、系统兼容性

3.1 版本兼容性说明

• 版本 1.16 及以下：支持 Windows 7/8.1/10 (x86 和 amd64)
• 版本 1.17 及以上：仅支持 Windows 10/11 (x86, amd64 和 ARM64)

重要限制：Windows Server 系统可能工作但不被支持，相关的错误报告和支持请求将被忽略。

四、项目结构与核心文件

4.1 主要目录结构

ViGEmBus/
├── sys/           # 驱动程序核心代码
├── app/           # 测试应用程序
├── setup/         # 安装相关文件
├── drivers/       # 驱动工具和文档
├── patches/       # 补丁文件
└── sdk/           # SDK文件

4.2 核心源代码文件

sys 目录包含驱动程序的核心实现：

• Driver.h/cpp：驱动程序主文件和头文件
• XusbPdo.hpp/cpp：Xbox 360控制器模拟实现
• Ds4Pdo.hpp/cpp：DualShock 4控制器模拟实现
• Queue.hpp/cpp：请求队列管理
• EmulationTargetPDO.hpp/cpp：设备模拟目标
• busenum.cpp：总线枚举器
• buspdo.cpp：总线物理设备对象

app 目录包含测试应用程序：

• app.cpp：主要的测试应用代码

五、许可证信息

ViGEmBus 采用 BSD-3-Clause 许可证，具体条款如下：

• 允许源代码和二进制形式的再分发，无论是否修改
• 必须保留版权声明和许可条件列表
• 不得使用版权持有者或贡献者的名称来认可或推广衍生作品

完整的许可证文本可以在项目的 LICENSE 文件中查看。

六、典型问题解决方案

6.1 安装时的"拒绝访问"错误

适用场景：双击安装程序后立即弹出权限错误

解决步骤：

1. 右键安装程序 → 选择"以管理员身份运行"
2. 如果还是失败，按下 Win+X → 选择"命令提示符(管理员)"
3. 在命令窗口切换到安装包目录执行安装

预防措施：

• 下载安装包后先关闭安全软件
• 将安装包保存到非系统盘根目录

6.2 设备管理器出现黄色感叹号

适用场景：驱动安装完成，但设备显示异常

解决步骤：

1. 按下 Win+X → 选择"设备管理器"
2. 展开"人体学输入设备"或"游戏控制器"分类
3. 找到带黄色感叹号的"ViGEm Bus Driver"
4. 右键 → "更新驱动程序" → "浏览我的计算机"
5. 选择 C:\Windows\System32\drivers\ViGEmBus.sys

6.3 游戏内按键无响应

适用场景：设备显示正常，但游戏没有反应

解决步骤：

1. 打开记事本测试键盘输入是否正常
2. 检查游戏设置中的"控制器"选项
3. 确保选择了ViGEm设备

七、编译与开发指南

7.1 编译前提条件

要编译 ViGEmBus 驱动程序，需要以下工具：

1. Visual Studio 2019：安装时勾选"驱动开发"组件
2. WDK for Windows 10：版本 2004 或更高
3. Driver Module Framework (DMF)：克隆到同一父目录中

7.2 编译步骤

1. 将 DMF 仓库克隆到与 ViGEmBus 相同的父目录
2. 构建 DmfK 项目，使用 Release 和 Debug 配置，支持所有架构
3. 在 Visual Studio 中打开 ViGEmBus.sln 解决方案文件
4. 选择正确的配置进行编译

重要提示：编译后的驱动程序需要签名才能在非测试模式下使用。

八、技术实现原理

ViGEmBus 作为游戏控制器的翻译官，其工作流程如下：

1. 应用程序发送控制指令：如按键操作、摇杆移动等
2. 驱动接收指令并转换：将通用指令转换为控制器专用协议
3. 系统识别为真实控制器：操作系统将其识别为物理连接的控制器
4. 游戏接收指令并响应：游戏程序接收输入并做出相应反应

九、已知用户和生态系统

ViGEmBus 被多个知名项目和公司使用，包括：

• 3dRudder - 3D运动控制器
• Parsec - 游戏流媒体服务
• DS4Windows - DualShock 4 Windows 驱动
• HP Omen - 游戏电脑系列
• Microsoft RdpGamepad - 远程桌面游戏手柄支持

十、技术支持与社区

虽然项目已经宣布退役，但代码仍然可以作为学习 Windows 驱动开发的优秀参考。对于技术问题，建议：

• 查阅项目文档和代码注释
• 参考 Windows 驱动开发官方文档
• 在相关技术社区寻求帮助

免责声明：由于项目已退役，使用此驱动可能需要自行承担风险，建议在生产环境中谨慎使用。