> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GameInputControllerAxisInfo（已弃用）

> GameInputControllerAxisInfo

# GameInputControllerAxisInfo

> [!WARNING]
>
> **已弃用。** 此结构已在 GameInput v3 中移除，当前 API 中不再提供。此信息现在通过 [GameInputControllerInfo](https://docs.xbox.com/zh-CN/reference/input/gameinput/structs/gameinputcontrollerinfo.md) 提供。

描述通用控制器设备上的一个轴。

## 语法

```cpp theme={null}
typedef struct GameInputControllerAxisInfo {
    GameInputLabel label;
    GameInputLocation location;
    uint32_t locationId;
    int64_t lowerLimit;
    int64_t upperLimit;
    uint64_t deadZone;
    uint64_t resolutionX;
    uint64_t resolutionY;
    bool isAbsolute;
    bool isLinear;
    bool hasDeadZone;
    bool noReturn;
} GameInputControllerAxisInfo;
```

## 成员

**label**\
类型：[GameInputLabel](https://docs.xbox.com/zh-CN/reference/input/gameinput/enums/gameinputlabel.md)

标识轴功能的标签。

**location**\
类型：[GameInputLocation](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputlocation.md)

轴在设备上的物理位置。

**locationId**\
类型：uint32\_t

用于区分同一位置上不同轴的标识符。

**lowerLimit**\
类型：int64\_t

轴的最小物理值。

**upperLimit**\
类型：int64\_t

轴的最大物理值。

**deadZone**\
类型：uint64\_t

围绕中心位置的死区大小。

**resolutionX**\
类型：uint64\_t

轴的水平分辨率。

**resolutionY**\
类型：uint64\_t

轴的垂直分辨率。

**isAbsolute**\
类型：bool

指示轴是报告绝对值 (true) 还是相对值 (false)。

**isLinear**\
类型：bool

指示轴是否具有线性响应。

**hasDeadZone**\
类型：bool

指示轴是否具有机械死区。

**noReturn**\
类型：bool

指示轴松开后是否不返回中心位置。

## 版本历史

| 版本 | 变更 |
| - | - |
| **v3** | 已移除。字段已集成到 [GameInputControllerInfo](https://docs.xbox.com/zh-CN/reference/input/gameinput/structs/gameinputcontrollerinfo.md) 中。 |
| **v2** | 无变更。 |
| **v1** | 无变更。 |
| **v0** | 已引入。 |

## 另请参阅

[已弃用的 GameInput API 成员](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
[GameInputControllerInfo](https://docs.xbox.com/zh-CN/reference/input/gameinput/structs/gameinputcontrollerinfo.md)


## Related topics

- [GameInputControllerButtonInfo（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputcontrollerbuttoninfo.md)
- [GameInputMotionInfo（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputmotioninfo.md)
- [GameInputHapticWaveformInfo（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputhapticwaveforminfo.md)
- [GameInputTouchSensorInfo（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputtouchsensorinfo.md)
- [GameInputUiNavigationInfo（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputuinavigationinfo.md)