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

# GetControllerButtonCount

> IGameInputReading::GetControllerButtonCount

# IGameInputReading::GetControllerButtonCount

擷取遊戲控制器上的按鈕數目。

## 語法

```cpp theme={null}
uint32_t GetControllerButtonCount();
```

### 參數

此方法沒有參數。

### 傳回值

類型：uint32\_t

傳回遊戲控制器上的按鈕數目。

## 備註

`IGameInputReading::GetControllerButtonCount` 方法會擷取遊戲控制器的按鈕數目。它也會決定 [IGameInputReading::GetControllerButtonState](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerbuttonstate.md) 方法所需的緩衝區。

如需 GameInput API 的中階與進階使用案例，請參閱[進階 GameInput 主題](https://docs.xbox.com/zh-TW/build/core-features/common/input/advanced/input-advanced-topics.md)。

## 需求

**標頭：** GameInput.h

[GameInput 概觀](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

- [GetControllerButtonState](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerbuttonstate.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)
- [GetControllerAxisCount](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxiscount.md)
- [GetControllerSwitchCount](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerswitchcount.md)