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

# GetExtraAxisCount

> GetExtraAxisCount

# GetExtraAxisCount

取得裝置中針對指定輸入類型存在的額外軸 (或未對應軸) 數目。

## 語法

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

### 參數

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

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

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

裝置中針對指定輸入類型存在的額外軸 (或未對應軸) 數目。

### 傳回值

類型：HRESULT

函式結果。

## 備註

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

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

## 需求

**標頭：** GameInput.h

**程式庫：** gameinput.lib

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

## 另請參閱

[GameInputKind](/zh-TW/reference/input/gameinput/enums/gameinputkind)<br />
[GetExtraAxisIndexes](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxisindexes)<br />
[GetExtraButtonCount](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttoncount)<br />
[IGameInputDevice](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## 版本歷程記錄

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


## Related topics

- [GetExtraAxisIndexes](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxisindexes.md)
- [GetExtraButtonCount](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttoncount.md)
- [IGameInputDevice](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [IGameInputReading::GetControllerAxisCount](/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxiscount.md)
- [GetExtraButtonIndexes](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttonindexes.md)