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

# XINPUT_CAPABILITIES

> XINPUT_CAPABILITIES

# XINPUT\_CAPABILITIES

Descreve as funcionalidades de um controle conectado.

## Sintaxe

```cpp theme={null}
typedef struct XINPUT_CAPABILITIES {  
    BYTE Type;  
    BYTE SubType;  
    WORD Flags;  
    XINPUT_GAMEPAD Gamepad;  
    XINPUT_VIBRATION Vibration;  
} XINPUT_CAPABILITIES  
```

### Membros

*Type*\
Tipo: BYTE

Tipo de controle. Deve ser do tipo XINPUT\_DEVTYPE\_GAMEPAD e ter um dos valores listados na tabela abaixo.

*SubType*\
Tipo: BYTE

Subtipo do controle de jogo.

Subtipos permitidos:

| Subtipo | Significado |
| - | - |
| XINPUT\_DEVSUBTYPE\_UNKNOWN | Desconhecido. O tipo de controle é desconhecido. |
| XINPUT\_DEVSUBTYPE\_GAMEPAD | Controle gamepad. Inclui os direcionais analógicos esquerdo e direito, os gatilhos esquerdo e direito, o direcional digital e todos os botões padrão: A, B, X, Y, START, BACK, LB, RB, LSB e RSB. |
| XINPUT\_DEVSUBTYPE\_WHEEL | Controle de volante de corrida. O eixo X do direcional analógico esquerdo relata a rotação do volante, o gatilho direito é o pedal do acelerador e o gatilho esquerdo é o pedal do freio. O direcional digital e a maioria dos botões padrão estão incluídos: A, B, X, Y, START, BACK, LB e RB. LSB e RSB são opcionais. |
| XINPUT\_DEVSUBTYPE\_ARCADE\_STICK | Controle de arcade stick. Inclui um direcional digital que é relatado como DPAD (para cima, para baixo, para a esquerda e para a direita) e a maioria dos botões padrão: A, B, X, Y, START e BACK. Os gatilhos esquerdo e direito são implementados como botões digitais e relatam 0 ou 0xFF. LB, LSB, RB e RSB são opcionais. |
| XINPUT\_DEVSUBTYPE\_FLIGHT\_STICK | Controle de flight stick. Inclui um manche de arfagem e rolagem que é relatado como o direcional analógico esquerdo, um POV Hat que é relatado como o direcional analógico direito, um leme (torção da alça ou balancim) que é relatado como o gatilho esquerdo e um controle de aceleração como o gatilho direito. Inclui suporte para uma arma primária (A), uma arma secundária (B) e outros botões padrão: X, Y, START e BACK. LB, LSB, RB e RSB são opcionais. |
| XINPUT\_DEVSUBTYPE\_DANCE\_PAD | Controle de tapete de dança. Inclui o direcional digital e os botões padrão (A, B, X e Y) no tapete, além de BACK e START. |
| XINPUT\_DEVSUBTYPE\_GUITAR XINPUT\_DEVSUBTYPE\_GUITAR\_ALTERNATE XINPUT\_DEVSUBTYPE\_GUITAR\_BASS | Controle de guitarra. A barra de palhetada é mapeada para o DPAD (para cima e para baixo), e os trastes são atribuídos a A (verde), B (vermelho), Y (amarelo), X (azul) e LB (laranja). O eixo Y do direcional analógico direito está associado a um sensor de orientação vertical, e o eixo X do direcional analógico direito é a alavanca de whammy. Há suporte para BACK, START e DPAD (esquerda, direita). O gatilho esquerdo (seletor de captador), o gatilho direito, RB, LSB (modificador de traste) e RSB são opcionais. Guitar Bass é idêntico a Guitar, com o subtipo distinto para simplificar a configuração. Guitar Alt dá suporte a uma faixa maior de movimento para o sensor de orientação vertical. |
| XINPUT\_DEVSUBTYPE\_DRUM\_KIT | Controle de bateria. Os pads da bateria são atribuídos a botões: A para verde (Floor Tom), B para vermelho (caixa), X para azul (Low Tom), Y para amarelo (High Tom) e LB para o pedal (bumbo). Direcional digital, BACK e START estão incluídos. RB, LSB e RSB são opcionais. |
| XINPUT\_DEVSUBTYPE\_ARCADE\_PAD | Controle de arcade pad. Inclui o direcional digital e a maioria dos botões padrão: A, B, X, Y, START, BACK, LB e RB. Os gatilhos esquerdo e direito são implementados como botões digitais e relatam 0 ou 0xFF. Direcional analógico esquerdo, direcional analógico direito, LSB e RSB são opcionais. |

*Flags*\
Tipo: WORD

Recursos do controle.

| Valor | Descrição |
| - | - |
| XINPUT\_CAPS\_VOICE\_SUPPORTED | O dispositivo tem um dispositivo de voz integrado. |
| XINPUT\_CAPS\_FFB\_SUPPORTED | O dispositivo dá suporte à funcionalidade de force feedback. No momento, recursos de force feedback além da vibração não têm suporte por meio do XINPUT no Windows. |
| XINPUT\_CAPS\_WIRELESS | O dispositivo é sem fio. |
| XINPUT\_CAPS\_PMD\_SUPPORTED | O dispositivo dá suporte a módulos plug-in. No momento, módulos plug-in (como o dispositivo de entrada de texto (TID)) não têm suporte por meio do XINPUT no Windows. |
| XINPUT\_CAPS\_NO\_NAVIGATION | O dispositivo não tem os botões de navegação de menu: START, BACK e DPAD. |

*Gamepad*\
Tipo: [XINPUT\_GAMEPAD](/pt-BR/reference/input/xinputongameinput/structs/xinput_gamepad)

Estrutura [XINPUT\_GAMEPAD](/pt-BR/reference/input/xinputongameinput/structs/xinput_gamepad) que descreve os recursos de controle e as resoluções de controle disponíveis.

*Vibration*\
Tipo: [XINPUT\_VIBRATION](/pt-BR/reference/input/xinputongameinput/structs/xinput_vibration)

Estrutura [XINPUT\_VIBRATION](/pt-BR/reference/input/xinputongameinput/structs/xinput_vibration) que descreve a funcionalidade de vibração e as resoluções disponíveis.

## Comentários

[XInputGetCapabilities](/pt-BR/reference/input/xinputongameinput/functions/xinputgetcapabilities) retorna XINPUT\_CAPABILITIES para indicar as características e a funcionalidade disponível de um controle especificado.

[XInputGetCapabilities](/pt-BR/reference/input/xinputongameinput/functions/xinputgetcapabilities) define os membros da estrutura para indicar a quais entradas o dispositivo dá suporte. Para controles de estado binário, como botões digitais, o bit correspondente indica se o controle tem suporte no dispositivo. Para controles proporcionais, como direcionais analógicos, o valor indica a resolução desse controle. Alguns dos bits menos significativos podem não estar definidos, para indicar que o controle não fornece resolução até esse nível.

O membro SubType indica o subtipo específico do controle presente. Os jogos podem detectar o subtipo do controle e ajustar o tratamento da entrada ou saída do controle de acordo com os subtipos adequados ao gênero do jogo. Por exemplo, um jogo de corrida de carros pode verificar a presença de um controle de volante para fornecer um controle mais preciso do carro que está sendo dirigido. No entanto, os títulos não devem desabilitar nem ignorar um dispositivo de acordo com seu subtipo. Um subtipo não reconhecido pelo jogo, ou para o qual o jogo não foi ajustado especificamente, deve ser tratado como um gamepad padrão, XINPUT\_DEVSUBTYPE\_GAMEPAD.

Os drivers XUSB mais antigos do Windows relatam informações sobre funcionalidades incompletas, especialmente para dispositivos sem fio. O driver XUSB mais recente do Windows oferece suporte completo a dispositivos com fio e sem fio e fornece sinalizadores de funcionalidades mais completos e precisos.

## Requisitos

**Cabeçalho:** XInputOnGameInput.h

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

## Confira também

[Portar o XInput para o GameInput](/pt-BR/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/pt-BR/reference/input/xinputongameinput/xinputongameinput_members)


## Related topics

- [XINPUT_CAPABILITIES](/zh-CN/reference/input/xinputongameinput/structs/xinput_capabilities.md)
- [XInputGetCapabilities](/reference/input/xinputongameinput/functions/xinputgetcapabilities.md)