> ## 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.

# GameInputControllerInfo（已弃用）

> 描述控制器的属性（已在 v4 中移除）。

> [!WARNING]
>
> **已弃用。** 此结构已在 GameInput v4 中移除，当前 API 中不再提供。请改用 [IGameInputDevice::GetControllerAxisCount](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrolleraxiscount.md)、[GetControllerAxisLabels](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrolleraxislabels.md)、[GetControllerButtonCount](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrollerbuttoncount.md)、[GetControllerButtonLabels](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrollerbuttonlabels.md)、[GetControllerSwitchCount](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrollerswitchcount.md) 和 [GetControllerSwitchInfo](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrollerswitchinfo.md)。

描述控制器的属性。

## 语法

```cpp theme={null}
struct GameInputControllerInfo
{
    uint32_t                             controllerAxisCount;
    const GameInputLabel*                controllerAxisLabels;
    uint32_t                             controllerButtonCount;
    const GameInputLabel*                controllerButtonLabels;
    uint32_t                             controllerSwitchCount;
    const GameInputControllerSwitchInfo* controllerSwitchInfo;
};
```

### 成员

*controllerAxisCount*\

类型：uint32\_t

控制器上的轴数量。

*controllerAxisLabels*\

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

控制器轴的标签。

*controllerButtonCount*\

类型：uint32\_t

控制器上的按钮数量。

*controllerButtonLabels*\

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

控制器按钮的标签。

*controllerSwitchCount*\

类型：uint32\_t

控制器上的开关数量。

*controllerSwitchInfo*\

类型：[GameInputControllerSwitchInfo](https://docs.xbox.com/zh-CN/reference/input/gameinput/structs/gameinputcontrollerswitchinfo.md) const \*

控制器开关的相关信息。

## 备注

`GameInputControllerInfo` 结构中的字段是指向可变大小信息数组的指针。空指针（NULL）表示相应功能在该控制器上不可用或不受支持。每个数组中的元素数量由结构中相应的字段指示（如 SAL 注释中所述）。

此结构用于 [GameInputDeviceInfo](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md) 结构中。`GameInputDeviceInfo` 由 [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md) 方法使用。

有关详细信息，请参阅 [GameInput 设备](https://docs.xbox.com/zh-CN/build/core-features/common/input/overviews/input-devices.md)。

## 要求

**头文件：** GameInput.h

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[已弃用的 GameInput API 成员](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)\
[IGameInputDevice](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)\
[GameInput 概述](https://docs.xbox.com/zh-CN/build/core-features/common/input/overviews/input-overview.md)\


[GameInput](https://docs.xbox.com/zh-CN/reference/input/gameinput/gameinput_members.md)

## 版本历史

| 版本 | 变更 |
| - | - |
| **v4** | 已移除。 |
| **v3** | 当前 API 中引入的**新结构**。取代 v0、v1 和 v2 中存在的独立 `GameInputControllerAxisInfo` 和 `GameInputControllerButtonInfo` 结构。 |


## Related topics

- [GameInputControllerAxisInfo（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputcontrolleraxisinfo.md)
- [GameInputControllerButtonInfo（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputcontrollerbuttoninfo.md)
- [已弃用的 GameInput API 成员](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [GameInputLocation（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputlocation.md)
- [GameInputDeviceInfo（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md)