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

# GetExtraAxisIndexes

> GetExtraAxisIndexes

# GetExtraAxisIndexes

Obtém os índices de eixo do controle dos eixos extras no dispositivo para um determinado tipo de entrada.

## Sintaxe

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

### Parâmetros

*inputKind*   \_In\_\
Tipo: GameInputKind

O tipo de entrada cujos índices de eixos extras estão sendo solicitados.

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

Contagem esperada de índices de eixo para eixos extras.
Esse número pode ser recuperado chamando  [GetExtraAxisCount](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxiscount).

*extraAxisIndexes*   \_Out\_writes\_(extraAxisCount)\_\
Tipo: uint8\_t\*

Ponteiro para a matriz de índices de eixo.

### Valor retornado

Tipo: HRESULT

Resultado da função.

## Comentários

O método `GetExtraAxisIndexes` recupera os índices de eixo do controle dos eixos extras presentes no dispositivo para um determinado tipo de entrada. Eixos extras são eixos do controle que existem no dispositivo físico, mas não fazem parte do mapeamento padrão para o tipo de entrada especificado.

Antes de chamar este método, você deve primeiro chamar [GetExtraAxisCount](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxiscount) para determinar quantos eixos extras estão disponíveis e passar essa contagem como o parâmetro extraAxisCount.

O exemplo de código a seguir demonstra como usar os eixos extras de um gamepad:

```cpp theme={null}
bool GetGamepadExtraAxisValues(
    std::vector<float>* extraAxes,
    IGameInputReading* reading) noexcept
{
    Mwrl::ComPtr<IGameInputDevice> device;
    reading->GetDevice(&device);

    uint32_t extraAxisCount = 0;
    if (FAILED(device->GetExtraAxisCount(GameInputKindGamepad, &extraAxisCount)))
    {
        return false;
    }

    std::vector<uint8_t> axisIndexes(extraAxisCount);
    extraAxes->resize(extraAxisCount);
    if (FAILED(device->GetExtraAxisIndexes(
        GameInputKindGamepad,
        extraAxisCount,
        axisIndexes.data())))
    {
        return false;
    }

    std::vector<float> axisStates(reading->GetControllerAxisCount());
    reading->GetControllerAxisState(static_cast<uint32_t>(axisStates.size()), axisStates.data());

    for (size_t i = 0; i < axisIndexes.size(); ++i)
    {
        if (axisIndexes[i] < axisStates.size())
        {
            (*extraAxes)[i] = axisStates[axisIndexes[i]];
        }
    }

    return true;
}
```

## Requisitos

**Cabeçalho:** GameInput.h

**Biblioteca:** gameinput.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

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

## Histórico de versões

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


## Related topics

- [GetExtraAxisCount](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxiscount.md)
- [GetExtraButtonIndexes](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttonindexes.md)
- [IGameInputDevice](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [GetExtraButtonCount](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttoncount.md)
- [GameInputArcadeStickInfo](/pt-BR/reference/input/gameinput/structs/gameinputarcadestickinfo.md)