> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GetExtraButtonCount

> GetExtraButtonCount

# GetExtraButtonCount

取得裝置中針對指定輸入類型存在的額外按鈕 (或不支援的按鈕) 數目。

## 語法

```cpp theme={null}
HRESULT GetExtraButtonCount(
    GameInputKind inputKind,
    uint32_t* extraButtonCount
);
```

### 參數

*inputKind*   \_In\_\
類型：GameInputKind

要求其額外按鈕數目的輸入類型。

*extraButtonCount*   \_Out\_\
類型：uint32\_t\*

裝置中針對指定輸入類型存在的額外按鈕 (或不支援的按鈕) 數目。

### 傳回值

類型：HRESULT

函式結果。

## 備註

額外按鈕是存在於實體裝置上、但不屬於指定輸入類型之標準對應的控制器按鈕。對於想要存取超出標準輸入對應之裝置特定按鈕的應用程式而言，此方法相當實用。

取得的數目預期會與 [GetExtraButtonIndexes](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttonindexes) 方法搭配使用，以擷取這些額外按鈕的特定索引，並配置正確的緩衝區空間來儲存該方法所提供的按鈕索引。

## 需求

**標頭：** GameInput.h

**程式庫：** gameinput.lib

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

## 另請參閱

[GameInputKind](/zh-TW/reference/input/gameinput/enums/gameinputkind)<br />
[GetExtraButtonIndexes](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttonindexes)<br />
[GetExtraAxisCount](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxiscount)<br />
[IGameInputDevice](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v3** | 已推出。 |


## Related topics

- [GetExtraButtonIndexes](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttonindexes.md)
- [GetExtraAxisCount](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxiscount.md)
- [IGameInputDevice](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [IGameInputReading::GetControllerButtonCount](/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerbuttoncount.md)
- [GetExtraAxisIndexes](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxisindexes.md)