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

# GameInputControllerSwitchInfo

> GameInputControllerSwitchInfo

# GameInputControllerSwitchInfo

Descreve um switch em um dispositivo de entrada.

## Sintaxe

```cpp theme={null}
struct GameInputControllerSwitchInfo
{
    GameInputLabel      labels[GAMEINPUT_MAX_SWITCH_STATES];
    GameInputSwitchKind kind;
};
```

### Membros

*labels*\

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

Os rótulos dos estados do switch.

*kind*\

Tipo: [GameInputSwitchKind](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputswitchkind.md)

O tipo do switch.

## Comentários

Essa estrutura é usada na estrutura [GameInputControllerInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/structs/gameinputcontrollerinfo.md). `GameInputControllerInfo` é usada pela estrutura [GameInputDeviceInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/structs/gameinputdeviceinfo.md) para descrever as propriedades de um dispositivo de entrada do tipo controle.

## 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** | **Removido** `mappedInputKinds`. O `label` singular foi substituído pela matriz `labels[GAMEINPUT_MAX_SWITCH_STATES]`. |
| **v1** | **Removidos** `positionLabels[9]` e todos os campos legados/brutos de HID e DInput (`legacyDInputIndex`, `legacyHidIndex`, `rawReportIndex`, ponteiros de relatório bruto). |
| **v0** | Introduzida. |

## Apêndice: versões anteriores

### v1, v2

```cpp theme={null}
struct GameInputControllerSwitchInfo
{
    GameInputKind       mappedInputKinds;
    GameInputLabel      label;
    GameInputSwitchKind kind;
};
```

### v0

```cpp theme={null}
struct GameInputControllerSwitchInfo
{
    GameInputKind       mappedInputKinds;
    GameInputLabel      label;
    GameInputLabel      positionLabels[9];
    GameInputSwitchKind kind;
    uint8_t             legacyDInputIndex;
    uint8_t             legacyHidIndex;
    uint16_t            rawReportIndex;
};
```


## Related topics

- [GameInputControllerInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/structs/gameinputcontrollerinfo.md)
- [GameInputSwitchKind](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputswitchkind.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)
- [GetControllerSwitchCount](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerswitchcount.md)