> ## 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 (Preterido)

> Descreve as propriedades de um controle (removida na v4).

> [!WARNING]
>
> **Preterido.** Esta estrutura foi removida no GameInput v4 e não está disponível na API atual. Em vez disso, use [IGameInputDevice::GetControllerAxisCount](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrolleraxiscount.md), [GetControllerAxisLabels](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrolleraxislabels.md), [GetControllerButtonCount](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrollerbuttoncount.md), [GetControllerButtonLabels](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrollerbuttonlabels.md), [GetControllerSwitchCount](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrollerswitchcount.md) e [GetControllerSwitchInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrollerswitchinfo.md).

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 chaves no controle.

*controllerSwitchInfo*\

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

Informações sobre as chaves no controle.

## Comentários

Os campos da estrutura `GameInputControllerInfo` são ponteiros 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).

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

Para obter mais informações, confira [Dispositivos do 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

[Membros preteridos da API GameInput](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)\
[IGameInputDevice](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)\
[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 |
| - | - |
| **v4** | Removida. |
| **v3** | **Nova estrutura** introduzida na API atual. Substitui as estruturas separadas `GameInputControllerAxisInfo` e `GameInputControllerButtonInfo` que existiam na v0, v1 e v2. |


## Related topics

- [GameInputControllerButtonInfo (Preterido)](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/structs/gameinputcontrollerbuttoninfo.md)
- [GameInputControllerAxisInfo (Preterido)](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/structs/gameinputcontrolleraxisinfo.md)
- [GameInputControllerInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/structs/gameinputcontrollerinfo.md)
- [GameInputDeviceInfo (Preterido)](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md)
- [GameInputControllerSwitchInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/structs/gameinputcontrollerswitchinfo.md)