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

# IGameInputReading::GetControllerAxisState

> IGameInputReading::GetControllerAxisState

# IGameInputReading::GetControllerAxisState

게임 컨트롤러에서 축 상태 정보를 검색합니다.

## 구문

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

### 매개변수

*stateArrayCount*   \_In\_\
형식: uint32\_t

게임 컨트롤러의 축을 캡처하는 데 필요한 상태 배열의 예상 개수입니다.
이 숫자는 [IGameInputReading::GetControllerAxisCount](/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxiscount)에서 검색할 수 있습니다.

*stateArray*   \_Out\_writes\_(stateArrayCount)
형식: float\*

축 상태 데이터가 포함된 배열에 대한 포인터입니다.

### 반환값

형식: uint32\_t

유효한 버퍼 항목의 수를 반환합니다.

## 설명

게임 컨트롤러의 대부분의 아날로그 컨트롤(조이스틱, 트리거, 슬라이더, 다이얼 등)은 축으로 표시되며, \[0.0, 1.0] 범위로 선형으로 정규화된 부동 소수점 값입니다. 대부분의 디지털 입력은 버튼으로 표시되며, 이는 단순한 부울 값입니다. 햇 스위치는 스위치 값으로 표시되며, 그 위치는 [GameInputSwitchPosition](/reference/input/gameinput/enums/gameinputswitchposition) 열거형 값 중 하나로 표현됩니다.

## 요구 사항

**헤더:** GameInput.h

[Input API 개요](/build/core-features/common/input/overviews/input-overview)\
[IGameInputReading](/reference/input/gameinput/interfaces/igameinputreading/igameinputreading)

## 버전 기록

| 버전     | 변경 사항 |
| ------ | ----- |
| **v0** | 도입됨.  |


## Related topics

- [IGameInputReading::GetControllerAxisCount](/ko/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxiscount.md)
- [IGameInputReading::GetControllerButtonState](/ko/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerbuttonstate.md)
- [IGameInputReading::GetControllerSwitchState](/ko/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerswitchstate.md)
- [IGameInputReading::GetControllerButtonCount](/ko/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerbuttoncount.md)
- [IGameInputReading::GetControllerSwitchCount](/ko/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerswitchcount.md)