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

# GameInputControllerInfo

> GameInputControllerInfo

# GameInputControllerInfo

Descreve as propriedades de um controle.

## Sintaxe

```cpp theme={null}
struct GameInputControllerInfo
{
    uint32_t                             controllerAxisCount;
    const GameInputLabel*                controllerAxisLabels;
    uint32_t                             controllerButtonCount;
    const GameInputLabel*                controllerButtonLabels;
    uint32_t                             controllerSwitchCount;
    const GameInputControllerSwitchInfo* controllerSwitchInfo;
};
```

### Membros

*controllerAxisCount*\

Tipo: uint32\_t

O número de eixos no controle.

*controllerAxisLabels*\

Tipo: [GameInputLabel](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputlabel.md) const \*

Os rótulos dos eixos no controle.

*controllerButtonCount*\

Tipo: uint32\_t

O número de botões no controle.

*controllerButtonLabels*\

Tipo: [GameInputLabel](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputlabel.md) const \*

Os rótulos dos botões no controle.

*controllerSwitchCount*\

Tipo: uint32\_t

O número de switches no controle.

*controllerSwitchInfo*\

Tipo: [GameInputControllerSwitchInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/structs/gameinputcontrollerswitchinfo.md) const \*

Informações sobre os switches no controle.

## Comentários

Os campos da estrutura `GameInputControllerInfo` que são ponteiros apontam para matrizes de tamanho variável com informações sobre o controle. Ponteiros NULL indicam que o recurso correspondente não está disponível ou não tem suporte no controle. O número de elementos em cada matriz é indicado por um campo correspondente na estrutura (conforme observado nas anotações SAL).

Essa estrutura é usada na estrutura [GameInputDeviceInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/structs/gameinputdeviceinfo.md). `GameInputDeviceInfo` é usada pelo método [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md).

Para obter mais informações, confira [Dispositivos GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-devices.md).

## Requisitos

**Cabeçalho:** GameInput.h

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

## Confira também

[Visão geral do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-overview.md)\


[GameInput](https://docs.xbox.com/pt-BR/reference/input/gameinput/gameinput_members.md)

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v3** | **Nova estrutura** introduzida na API atual. Substitui as estruturas separadas `GameInputControllerAxisInfo` e `GameInputControllerButtonInfo` que existiam na v0, v1 e v2. |


## Related topics

- [GameInputControllerSwitchInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/structs/gameinputcontrollerswitchinfo.md)
- [GameInputControllerAxisInfo (Preterido)](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/structs/gameinputcontrolleraxisinfo.md)
- [GameInputControllerButtonInfo (Preterido)](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/structs/gameinputcontrollerbuttoninfo.md)
- [GameInputLabel](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputlabel.md)
- [Membros da API do GameInput](https://docs.xbox.com/pt-BR/reference/input/gameinput/gameinput_members.md)