ViGEmBus 安装与配置完全指南
项目地址:https://gitcode.com/gh_mirrors/vi/ViGEmBus
项目基础介绍
ViGEmBus 是一个专为Windows设计的开源内核模式驱动程序,它能够模拟知名USB游戏控制器,如微软Xbox 360控制器和索尼DualShock 4控制器。这个项目由Nefarius维护,并且已经退役,但其强大的功能仍被许多用户所青睐。ViGEmBus通过在底层仿真设备,使得软件无需任何额外修改就能识别这些虚拟的游戏手柄,提供了高度的灵活性和兼容性。
主要编程语言: C++, C, PowerShell, C#, Shell 和 Batchfile
关键技术和框架
- Kernel-Mode Driver Framework (KMDF): ViGEmBus的核心构建于Microsoft的KMDF之上,这允许更安全、高效地编写内核级别的驱动程序。
- Driver Module Framework (DMF): 在构建过程中依赖于外部框架DMF,用于增加模块化和功能性。
- USB HID Emulation: 实现了高级的USB人机接口设备(HID)仿真技术,模拟真实游戏控制器的行为。
安装与配置步骤
准备工作
- 系统要求: 确保你的计算机运行的是Windows 7/8.1/10或更高版本(对于最新的版本,仅支持Windows 10/11)。
- 开发环境: 若需从源代码编译,需要安装Visual Studio 2019及相应的Windows Driver Kit (WDK) 版本2004。
- DMF框架: 下载并正确配置Driver Module Framework,将其置于与ViGEmBus同一父目录下。
详细安装步骤(适用于最终用户)
- 获取最新版本: 访问 ViGEmBus GitHub Release 页面,下载适合您系统的最新预编译的安装包。
- 关闭杀毒软件: 有时安全软件可能会误报驱动程序文件,因此在安装前临时禁用可能需要。
- 执行安装: 双击下载的
.exe
文件进行安装。按照向导的指示进行,通常只需点击“下一步”直到完成。 - 测试驱动: 安装后,你可以通过相关的客户端软件(如ViGEmClient或其他支持ViGEmBus的应用)来测试虚拟控制器的功能是否正常。
开发者编译步骤(可选)
- 环境设置: 按照准备工作中提到的步骤配置好Visual Studio和WDK。
- 克隆仓库: 使用Git克隆ViGEmBus项目到本地,命令如下:
git clone https://github.com/nefarius/ViGEmBus.git
- 编译驱动: 打开ViGEmBus解决方案(
ViGEmBus.sln
),确保选择正确的配置(Release/x64等),然后构建解决方案。 - 签名驱动: 对于非测试模式下的使用,你需要对编译出的驱动进行数字签名。
注意事项
- 签名驱动: 对于非测试环境下,未经签名的驱动不能安装。可以考虑使用试用版的签名工具,或者申请自己的代码签名证书。
- 服务器系统不支持: 不要在Windows Server上尝试安装,官方声明未提供支持。
现在,无论你是希望模拟游戏控制器的普通用户还是想要探索其内部机制的开发者,都可以跟随上述步骤顺利安装和配置ViGEmBus。享受自由配置游戏控制的乐趣吧!