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

一、核心功能解析

1.1 什么是 ViGEmBus？

ViGEmBus 是一款运行在内核模式（直接与硬件交互的底层程序）的 Windows 驱动程序，它能让你的电脑"假装"连接了真实的游戏控制器。就像用软件画了一张超级逼真的假身份证，游戏完全看不出区别！🛠️

1.2 支持设备对比表

设备类型	技术名称	常见用途	模拟精度
Xbox 360 控制器	Xusb	大部分Xbox/PC游戏	⭐⭐⭐⭐⭐
DualShock 4 控制器	Ds4	PS4游戏及模拟器	⭐⭐⭐⭐

💡 提示：项目通过 XusbPdo.cpp 和 Ds4Pdo.cpp 两个核心文件分别实现上述设备的模拟逻辑

1.3 工作原理简析

想象 ViGEmBus 是个游戏控制器翻译官：

1. 应用程序发送控制指令（比如"按下A键"）
2. 驱动接收指令并转换为控制器专用语言
3. 系统以为真的有控制器连接，把指令传递给游戏
4. 游戏做出相应反应（角色跳跃）

二、典型场景问题

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

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

解决步骤：

1. 右键安装程序 → 选择"以管理员身份运行"（盾牌图标那个选项）
2. 如果还是失败，按下 Win+X → 选择"命令提示符(管理员)"
3. 在命令窗口输入 cd C:\你的安装包路径，然后输入安装包文件名

⚠️ 注意：Windows 10/11 家庭版用户需要先启用管理员账户

预防措施：

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

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

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

解决步骤：

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

💡 提示：如果更新失败，尝试删除设备后重新扫描硬件更改

预防措施：

• 安装前创建系统还原点
• 不要同时安装其他游戏控制器驱动

2.3 游戏内按键无响应

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

解决步骤：

1. 打开记事本，测试键盘输入是否正常（排除硬件问题）
2. 检查游戏设置中的"控制器"选项，确保选择了ViGEm设备
3. 运行 Queue.cpp 中的诊断函数（需开发者模式）

预防措施：

• 启动游戏前先运行ViGEm测试工具
• 避免同时运行多个控制器模拟软件

三、进阶排查技巧

3.1 日志分析方法

ViGEmBus 会生成详细的运行日志，查看方法：

1. 按 Win+R → 输入 eventvwr.msc 打开事件查看器
2. 展开"Windows日志" → "应用程序"
3. 在右侧筛选栏搜索"ViGEm"关键词
4. 重点关注"错误"级别日志的"Bus_XusbSubmitReportHandler"相关条目

3.2 驱动版本管理

不同游戏可能需要特定版本的驱动，推荐管理方法：

1. 创建版本文件夹：D:\ViGEmVersions\v1.16、D:\ViGEmVersions\v1.17
2. 每个文件夹保存对应版本的安装程序和卸载脚本
3. 使用批处理文件快速切换版本：

   @echo 卸载当前版本
   vigem_uninstall.exe /quiet
   @echo 安装v1.16版本
   D:\ViGEmVersions\v1.16\vigem_setup.exe /silent
   

3.3 编译自定义版本

如果你需要修改驱动功能（需C++基础）：

1. 安装 Visual Studio 2022 并勾选"驱动开发"组件
2. 克隆仓库：git clone https://gitcode.com/gh_mirrors/vig/ViGEmBus
3. 打开 ViGEmBus.sln 解决方案
4. 修改 sys\Queue.hpp 中的回调函数
5. 选择"配置管理器" → 设置为"Release"和"x64"
6. 右键解决方案 → "生成"

⚠️ 注意：自定义驱动需要测试签名才能安装，普通用户建议使用官方版本

附录：常见问题速查表

问题现象	可能原因	快速解决
安装程序闪退	权限不足	管理员身份运行
设备代码43	驱动签名问题	启用测试签名
仅部分按键有效	报告处理错误	检查Ds4SubmitReport函数
重启后失效	服务未自启动	运行 sc config ViGEmBus start= auto

提示：更多问题可以查看项目中的 updates.txt 文件，包含历代版本修复记录