> ## 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-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerbuttoncount.md) 擷取

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

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v0** | 推出。 |


## Related topics

- [GetControllerButtonCount](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerbuttoncount.md)
- [IGameInputReading (介面內容)](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/igameinputreading.md)
- [與不同的 GameInput 裝置類型互動](https://docs.xbox.com/zh-TW/build/core-features/common/input/hardware/input-hardware-interfaces.md)
- [GetControllerAxisState](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxisstate.md)
- [GetControllerSwitchState](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerswitchstate.md)