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

# GetControllerAxisState

> IGameInputReading::GetControllerAxisState

# IGameInputReading::GetControllerAxisState

從遊戲控制器擷取軸狀態資訊。

## 語法

```cpp theme={null}
uint32_t GetControllerAxisState(
    uint32_t stateArrayCount,
    float* stateArray
);
```

### 參數

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

用來擷取遊戲控制器上各軸的預期狀態陣列數目。
此數目可從 [IGameInputReading::GetControllerAxisCount](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxiscount.md) 擷取

*stateArray*   \_Out\_writes\_(stateArrayCount)
類型：float\*

指向包含軸狀態資料之陣列的指標。

### 傳回值

類型：uint32\_t

傳回有效的緩衝區項目數目。

## 備註

遊戲控制器上大部分的類比控制項 (搖桿、扳機、滑桿、轉盤等) 都會以軸的形式呈現，軸是線性正規化至 \[0.0, 1.0] 範圍的浮點數值。大部分的數位輸入會以按鈕的形式呈現，按鈕是簡單的布林值。帽型開關會以開關值的形式呈現，其位置以其中一個 [GameInputSwitchPosition](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputswitchposition.md) 列舉值表示。

## 需求

**標頭：** GameInput.h

[輸入 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

- [IGameInputReading (介面內容)](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/igameinputreading.md)
- [GetControllerAxisCount](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxiscount.md)
- [GetControllerButtonState](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerbuttonstate.md)
- [GetControllerSwitchState](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerswitchstate.md)
- [GameInputControllerAxisInfo (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/structs/gameinputcontrolleraxisinfo.md)