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

# GetControllerButtonState

> IGameInputReading::GetControllerButtonState

# IGameInputReading::GetControllerButtonState

从游戏控制器检索按钮状态信息。

## 语法

```cpp theme={null}
uint32_t GetControllerButtonState(
    uint32_t stateArrayCount,
    bool* stateArray
);
```

### 参数

*stateArrayCount*   \_In\_\\
类型：uint32\_t

游戏控制器上按钮的预期数量。
可通过调用 [IGameInputReading::GetControllerButtonCount](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerbuttoncount.md) 获取此数值。

[输入 API 概述](https://docs.xbox.com/zh-CN/build/core-features/common/input/overviews/input-overview.md)\
[IGameInputReading](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputreading/igameinputreading.md)

## 版本历史

| 版本 | 更改 |
| - | - |
| **v0** | 引入。 |


## Related topics

- [GetControllerButtonCount](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerbuttoncount.md)
- [与不同 GameInput 设备类型交互](https://docs.xbox.com/zh-CN/build/core-features/common/input/hardware/input-hardware-interfaces.md)
- [GetControllerAxisState](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxisstate.md)
- [GetControllerSwitchState](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerswitchstate.md)
- [XFrontPanelGetButtonStates](https://docs.xbox.com/zh-CN/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelgetbuttonstates.md)