跳转到主要内容
获取输入设备的根设备节点的应用本地 ID。

语法

参数

deviceRootId   _Out_
类型:APP_LOCAL_DEVICE_ID*
接收根设备节点的应用本地 ID。

返回值

类型:void

备注

根设备 ID 是一个应用本地 ID,用于标识组合设备的根设备节点。这允许应用推断各个设备之间的关系。例如,一些游戏键盘通过将自己作为具有多个键盘节点的组合设备来暴露,从而绕过了 8 个同时按键的旧版 USB 限制。这些节点会被合并到“系统”键盘中,因此这一细节对用户通常是透明的。但是当通过 GameInput API 处理每个键盘的输入时,了解这种关系可以帮助应用在将功能映射到按键时避免做出不合理的假设(例如,假设按键始终来自特定设备)。 报告相同根设备 ID 的设备属于同一个组合设备。如果设备不是组合设备上的多个接口之一,则根设备 ID 与 IGameInputDevice::GetDeviceId 返回的 ID 相同。 在 GameInput v3 及更早版本中,此信息可从 IGameInputDevice::GetDeviceInfo 返回的 GameInputDeviceInfo 结构的 deviceRootId 成员中获取。

要求

头文件: GameInput.h 库: gameinput.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

另请参阅

GameInput 概述
IGameInputDevice
IGameInputDevice::GetDeviceId
IGameInputDevice::GetContainerId
APP_LOCAL_DEVICE_ID

版本历史

最后修改于 2026年11月6日