HKLM\SOFTWARE\Microsoft\GameInputRedist 中找到。Windows.Gaming.Input (WGI) API 共享这些映射,并针对 GameInput 提供额外扩展。有关详细信息,请参阅游戏控制器的注册表数据。GameInput 设备映射工具可让硬件开发人员为其设备生成这些映射,并实时测试。
启动该工具时,你可以选择一个已连接的游戏手柄配件。GameInput 会枚举所有启用 XInput 的设备,以及用途页为 0x0001(通用桌面控件)且用途为 0x0005(游戏手柄)或 0x0004(游戏杆)的 HID 设备。当你选择设备时,工具默认显示对应的 GameInput 读取和设备信息。
进入配置流程后,你可以从 Windows PC 上当前可用的任何配置(若有)继续,也可从此工具创建的现有注册表文件继续,或者从零开始。工具会引导你完成将设备的输入报告映射到诸如游戏手柄、飞行操纵杆、赛车方向盘和 UI 导航控制器等 GameInput 接口的过程。随后你可以将这些映射与设备专属的标签对齐,也可以默认使用 XInput 设备所用的标签。你还可以添加对高级功能(如触觉反馈和陀螺仪)的支持。最后,在提交更改前可实时测试所生成的映射。
该工具可将映射导出为文件。你可以手动将文件提交给 Microsoft 供审议(在 GameInput NuGet 页面使用 “Contact Owners” 链接),随驱动程序一起分发,或包含在应用程序的安装包中。
GameInput 设备映射工具与测试指南
GameInput 设备映射工具与测试指南
GameInput 设备映射工具可在 GameInput GitHub 项目中获取,是一款供硬件开发人员测试 GameInput API 如何识别并映射其设备的实用程序。该工具提供了可视化界面,用于检查设备的输入报告,以及 API 生成的对应 GameInput 读取和设备信息。这些信息对于调试和验证新设备的行为,或理解现有设备如何被 GameInput 解释尤为有帮助。
由于通用 HID 设备可能被目标系统以多种方式解释,GameInput 依赖于内置在 Windows 注册表中的一系列设备映射扩展,可在
最后修改于 2026年8月13日
