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

# GetControllerAxisState

> IGameInputReading::GetControllerAxisState

# IGameInputReading::GetControllerAxisState

Recupera informações de estado dos eixos de um controle de jogo.

## Sintaxe

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

### Parâmetros

*stateArrayCount*   \_In\_\
Tipo: uint32\_t

O número esperado de matrizes de estado para capturar os eixos em um controle de jogo.
Esse número pode ser recuperado de [IGameInputReading::GetControllerAxisCount](/pt-BR/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxiscount)

*stateArray*   \_Out\_writes\_(stateArrayCount)
Tipo: float\*

Ponteiro para as matrizes que contêm os dados de estado dos eixos.

### Valor retornado

Tipo: uint32\_t

Retorna o número de entradas válidas do buffer.

## Comentários

A maioria dos controles analógicos em um controle de jogo (joysticks, gatilhos, controles deslizantes, botões giratórios etc.) é exposta como eixos, que são valores de ponto flutuante normalizados linearmente para o intervalo \[0.0, 1.0]. A maioria das entradas digitais é exposta como botões, que são valores booleanos simples. Os hat switches são expostos como valores de switch, e sua posição é representada por um dos valores da enumeração [GameInputSwitchPosition](/pt-BR/reference/input/gameinput/enums/gameinputswitchposition).

## Requisitos

**Cabeçalho:** GameInput.h

[Visão geral da API de entrada](/pt-BR/build/core-features/common/input/overviews/input-overview)\
[IGameInputReading](/pt-BR/reference/input/gameinput/interfaces/igameinputreading/igameinputreading)

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v0** | Introduzido. |


## Related topics

- [IGameInputReading (conteúdo da interface)](/pt-BR/reference/input/gameinput/interfaces/igameinputreading/igameinputreading.md)
- [GetControllerAxisCount](/pt-BR/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxiscount.md)
- [GetControllerButtonState](/pt-BR/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerbuttonstate.md)
- [GetControllerSwitchState](/pt-BR/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerswitchstate.md)
- [GameInputControllerAxisInfo (Preterido)](/pt-BR/reference/input/gameinput/deprecated/structs/gameinputcontrolleraxisinfo.md)