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

> GameInputControllerInfo

# GameInputControllerInfo

描述控制器的屬性。

## 語法

```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-TW/reference/input/gameinput/enums/gameinputlabel.md) const \*

控制器上各軸的標籤。

*controllerButtonCount*\

類型：uint32\_t

控制器上的按鈕數目。

*controllerButtonLabels*\

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

控制器上各按鈕的標籤。

*controllerSwitchCount*\

類型：uint32\_t

控制器上的開關數目。

*controllerSwitchInfo*\

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

控制器上開關的相關資訊。

## 備註

`GameInputControllerInfo` 結構中的欄位是指向控制器相關資訊之可變大小陣列的指標。NULL 指標表示控制器不提供或不支援對應的功能。每個陣列中的元素數目由結構中對應的欄位指示 (如 SAL 註釋中所述)。

此結構用於 [GameInputDeviceInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/structs/gameinputdeviceinfo.md) 結構中。`GameInputDeviceInfo` 由 [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md) 方法使用。

如需詳細資訊，請參閱 [GameInput 裝置](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-devices.md)。

## 需求

**標頭：** GameInput.h

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[GameInput 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-overview.md)\


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

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v3** | 在目前的 API 中推出的**新結構**。取代 v0、v1 和 v2 中個別存在的 `GameInputControllerAxisInfo` 和 `GameInputControllerButtonInfo` 結構。 |


## Related topics

- [GameInputControllerSwitchInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/structs/gameinputcontrollerswitchinfo.md)
- [GameInputControllerAxisInfo (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/structs/gameinputcontrolleraxisinfo.md)
- [GameInputControllerButtonInfo (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/structs/gameinputcontrollerbuttoninfo.md)
- [GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)
- [GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/gameinput_members.md)