GameInputDeviceInfo（已弃用）

已弃用。 此结构已在 GameInput v4 中移除，当前 API 中不再提供。请改用 IGameInputDevice 上的各个 getter 方法。请参阅“备注”部分中的对应关系表。

描述有关输入设备的所有信息。

语法

struct GameInputDeviceInfo
{
    uint16_t               vendorId;
    uint16_t               productId;
    uint16_t               revisionNumber;
    GameInputUsage         usage;
    GameInputVersion       hardwareVersion;
    GameInputVersion       firmwareVersion;
    APP_LOCAL_DEVICE_ID    deviceId;
    APP_LOCAL_DEVICE_ID    deviceRootId;
    GameInputDeviceFamily  deviceFamily;
    GameInputKind          supportedInput;
    GameInputRumbleMotors  supportedRumbleMotors;
    GameInputSystemButtons supportedSystemButtons;
    GUID                   containerId;
    const char*            displayName;
    const char*            pnpPath;

    const GameInputKeyboardInfo* keyboardInfo;
    const GameInputMouseInfo*    mouseInfo;
    const GameInputSensorsInfo*  sensorsInfo;

    const GameInputControllerInfo*  controllerInfo;
    const GameInputArcadeStickInfo* arcadeStickInfo;
    const GameInputFlightStickInfo* flightStickInfo;
    const GameInputGamepadInfo*     gamepadInfo;
    const GameInputRacingWheelInfo* racingWheelInfo;

    uint32_t                               forceFeedbackMotorCount;
    const GameInputForceFeedbackMotorInfo* forceFeedbackMotorInfo;

    uint32_t                            inputReportCount;
    const GameInputRawDeviceReportInfo* inputReportInfo;

    uint32_t                            outputReportCount;
    const GameInputRawDeviceReportInfo* outputReportInfo;
};

成员

vendorId
类型：uint16_t 标识输入设备的供应商。 productId
类型：uint16_t 将输入设备标识为一个产品。 revisionNumber
类型：uint16_t 设备的硬件修订号（如果有）。 usage
类型：GameInputUsage 描述所用输入的两部分索引。 hardwareVersion
类型：GameInputVersion 设备的硬件版本（如果有）。 firmwareVersion
类型：GameInputVersion 设备的固件版本（如果有）。 deviceId
类型：APP_LOCAL_DEVICE_ID 输入设备的设备 ID。 deviceRootId
类型：APP_LOCAL_DEVICE_ID 输入设备的根 ID。 deviceFamily
类型：GameInputDeviceFamily 指定输入设备所属的输入设备族。 supportedInput
类型：GameInputKind 描述设备支持的一种或多种输入类型。 supportedRumbleMotors
类型：GameInputRumbleMotors 描述设备上可访问的震动马达（如果有）。 supportedSystemButtons
类型：GameInputSystemButtons 描述用于控制系统（通常在游戏外部）的可用按钮。 containerId
类型：GUID 输入设备的容器 ID。 displayName
类型：const char* 描述该设备的友好名称。 pnpPath
类型：const char* 描述该设备的即插即用能力。可通过此路径经由其他 API 引用底层设备。 keyboardInfo
类型：GameInputKeyboardInfo const * 有关键盘输入设备的信息。 mouseInfo
类型：GameInputMouseInfo const * 有关鼠标输入设备的信息。 sensorsInfo
类型：GameInputSensorsInfo const * 有关设备传感器的信息。 controllerInfo
类型：GameInputControllerInfo const * 有关通用控制器输入设备的信息。控制器代表设备上未映射的原始轴、按钮和开关。 arcadeStickInfo
类型：GameInputArcadeStickInfo const * 有关街机摇杆输入设备的信息。 flightStickInfo
类型：GameInputFlightStickInfo const * 有关飞行摇杆输入设备的信息。 gamepadInfo
类型：GameInputGamepadInfo const * 有关游戏手柄输入设备的信息。 racingWheelInfo
类型：GameInputRacingWheelInfo const * 有关赛车方向盘输入设备的信息。 forceFeedbackMotorCount
类型：uint32_t 输入设备上的力反馈马达数量。 forceFeedbackMotorInfo
类型：GameInputForceFeedbackMotorInfo const * 设备上所有力反馈马达的信息。 inputReportCount
类型：uint32_t 设备输入报告的数量。 inputReportInfo
类型：GameInputRawDeviceReportInfo const * 输入报告信息对象。 outputReportCount
类型：uint32_t 设备输出报告的数量。 outputReportInfo
类型：GameInputRawDeviceReportInfo const * 输出报告。

备注

此结构中的所有字符串成员均使用 UTF-8 编码。 deviceId 是应用本地 ID：一个能够唯一标识设备的 256 位哈希值。只要设备连接到相同的 USB 端口，该 ID 对于给定设备始终保持不变，即使应用重新运行或系统重启也是如此。应用本地 ID 的哈希值由应用生成，部分使用了调用应用和系统的特定信息。 deviceRootId 是另一个应用本地 ID，用于标识组合设备的根设备节点。这允许应用推断各个设备之间的关系。例如，一些游戏键盘通过将自己作为具有多个键盘节点的组合设备来暴露，从而绕过了 8 个同时按键的旧版 USB 限制。这些节点会被合并到“系统”键盘中，因此这一细节对用户通常是透明的。但是当通过 GameInput API 处理每个键盘的输入时，了解这一点可以帮助应用在将功能映射到按键时避免做出不合理的假设（例如，假设按键始终来自特定设备）。如果设备不是组合设备的多个接口之一，则 deviceId 和 deviceRootId 相同。 displayName 字符串包含设备的“友好”名称。你可以在应用的 UI 中显示此字符串，但不保证它已本地化。缺少本地化是因为 GameInput API 会在多个位置搜索此字符串，最后的回退之一来自设备的固件。 GameInputDeviceInfo 结构中的最后几个字段是指向可变大小信息数组的指针，例如关于力反馈和触觉反馈支持的信息。NULL 指针表示该设备不可用或不支持相应功能。结构中相应的字段指示每个数组的元素数量，如源注释语言 (SAL) 注释所述。没有任何输入设备为所有属性提供可读值。有些设备只包含相关属性的值。系统通过 IGameInputDevice::GetDeviceInfo 返回此信息。

GameInput v4 中的替代方法

在 GameInput v4 中，GameInputDeviceInfo 的每个成员都由 IGameInputDevice 上的一个 getter 方法取代。

v3 成员	v4 替代项
`vendorId`	GetVendorId
`productId`	GetProductId
`revisionNumber`	GetRevisionNumber
`usage`	GetUsage
`hardwareVersion`	GetHardwareVersion
`firmwareVersion`	GetFirmwareVersion
`deviceId`	GetDeviceId
`deviceRootId`	GetDeviceRootId
`deviceFamily`	GetDeviceFamily
`supportedInput`	GetSupportedInput
`supportedRumbleMotors`	GetSupportedRumbleMotors
`supportedSystemButtons`	GetSupportedSystemButtons
`containerId`	GetContainerId
`displayName`	GetDisplayName
`pnpPath`	GetPnpPath
`keyboardInfo`	GetKeyboardInfo
`mouseInfo`	GetMouseInfo
`sensorsInfo`	GetSensorsInfo
`controllerInfo`	GetControllerAxisCount、GetControllerAxisLabels、GetControllerButtonCount、GetControllerButtonLabels、GetControllerSwitchCount、GetControllerSwitchInfo
`arcadeStickInfo`	GetArcadeStickInfo
`flightStickInfo`	GetFlightStickInfo
`gamepadInfo`	GetGamepadInfo
`racingWheelInfo`	GetRacingWheelInfo
`forceFeedbackMotorCount`	GetForceFeedbackMotorCount
`forceFeedbackMotorInfo`	GetForceFeedbackMotorInfo
`inputReportCount`	GetInputReportCount
`inputReportInfo`	GetInputReportInfo
`outputReportCount`	GetOutputReportCount
`outputReportInfo`	GetOutputReportInfo

当设备不具备相应类型的输入时，用于设备特定信息的指针成员（例如 keyboardInfo 和 gamepadInfo）为 NULL。在这种情况下，对应的 v4 getter（例如 GetKeyboardInfo 和 GetGamepadInfo）返回 false。

概念文档

另请参阅

已弃用的 GameInput API 成员
IGameInputDevice
输入 API 概述
GameInput
IGameInputDevice::GetDeviceInfo

版本历史

版本	变更
v4	已移除。
v3	将 `uiNavigationInfo` 替换为 `controllerInfo` 指针。将独立的轴/按钮/开关计数+信息字段替换为 `controllerInfo`。新增 `inputReportCount`/`inputReportInfo` 和 `outputReportCount`/`outputReportInfo`。移除 `hapticFeedbackMotorInfo`。
v2	新增 `revisionNumber`、`hardwareVersion`、`firmwareVersion`、`containerId` (GUID) 和 `sensorsInfo` 指针。
v1	相对于 v0 大幅简化：移除 `infoSize`、`interfaceNumber`、`collectionNumber`、`capabilities` (GameInputDeviceCapabilities) 以及触摸/触觉/字符串/描述符计数字段；新增 `supportedSystemButtons`、`displayName`（类型为 `const char*`）和 `pnpPath`。
v0	引入。

附录：以前的版本

v2

struct GameInputDeviceInfo
{
    uint16_t               vendorId;
    uint16_t               productId;
    uint16_t               revisionNumber;
    GameInputUsage         usage;
    GameInputVersion       hardwareVersion;
    GameInputVersion       firmwareVersion;
    APP_LOCAL_DEVICE_ID    deviceId;
    APP_LOCAL_DEVICE_ID    deviceRootId;
    GameInputDeviceFamily  deviceFamily;
    GameInputKind          supportedInput;
    GameInputRumbleMotors  supportedRumbleMotors;
    GameInputSystemButtons supportedSystemButtons;
    GUID                   containerId;
    const char*            displayName;
    const char*            pnpPath;

    const GameInputKeyboardInfo* keyboardInfo;
    const GameInputMouseInfo*    mouseInfo;
    const GameInputSensorsInfo*  sensorsInfo;

    const GameInputUiNavigationInfo* uiNavigationInfo;
    const GameInputArcadeStickInfo*  arcadeStickInfo;
    const GameInputFlightStickInfo*  flightStickInfo;
    const GameInputGamepadInfo*      gamepadInfo;
    const GameInputRacingWheelInfo*  racingWheelInfo;

    uint32_t                              controllerAxisCount;
    const GameInputControllerAxisInfo*    controllerAxisInfo;
    uint32_t                              controllerButtonCount;
    const GameInputControllerButtonInfo*  controllerButtonInfo;
    uint32_t                              controllerSwitchCount;
    const GameInputControllerSwitchInfo*  controllerSwitchInfo;

    uint32_t                               forceFeedbackMotorCount;
    const GameInputForceFeedbackMotorInfo* forceFeedbackMotorInfo;

    uint32_t                                hapticFeedbackMotorCount;
    const GameInputHapticFeedbackMotorInfo* hapticFeedbackMotorInfo;
};

v1

struct GameInputDeviceInfo
{
    uint16_t               vendorId;
    uint16_t               productId;
    GameInputUsage         usage;
    APP_LOCAL_DEVICE_ID    deviceId;
    APP_LOCAL_DEVICE_ID    deviceRootId;
    GameInputDeviceFamily  deviceFamily;
    GameInputKind          supportedInput;
    GameInputRumbleMotors  supportedRumbleMotors;
    GameInputSystemButtons supportedSystemButtons;
    const char*            displayName;
    const char*            pnpPath;

    const GameInputKeyboardInfo* keyboardInfo;
    const GameInputMouseInfo*    mouseInfo;

    const GameInputUiNavigationInfo* uiNavigationInfo;
    const GameInputArcadeStickInfo*  arcadeStickInfo;
    const GameInputFlightStickInfo*  flightStickInfo;
    const GameInputGamepadInfo*      gamepadInfo;
    const GameInputRacingWheelInfo*  racingWheelInfo;

    uint32_t                              controllerAxisCount;
    const GameInputControllerAxisInfo*    controllerAxisInfo;
    uint32_t                              controllerButtonCount;
    const GameInputControllerButtonInfo*  controllerButtonInfo;
    uint32_t                              controllerSwitchCount;
    const GameInputControllerSwitchInfo*  controllerSwitchInfo;

    uint32_t                               forceFeedbackMotorCount;
    const GameInputForceFeedbackMotorInfo* forceFeedbackMotorInfo;

    uint32_t                                hapticFeedbackMotorCount;
    const GameInputHapticFeedbackMotorInfo* hapticFeedbackMotorInfo;
};

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

语法

成员

备注

GameInput v4 中的替代方法

概念文档

另请参阅

版本历史

附录：以前的版本

v2

v1

​语法

​成员

​备注

​GameInput v4 中的替代方法

​概念文档

​另请参阅

​版本历史

​附录：以前的版本

​v2

​v1

语法

成员

备注

GameInput v4 中的替代方法

概念文档

另请参阅

版本历史

附录：以前的版本

v2

v1