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

> XINPUT_GAMEPAD

# XINPUT\_GAMEPAD

Descreve o estado atual do controle.

## Sintaxe

```cpp theme={null}
typedef struct XINPUT_GAMEPAD {  
    WORD wButtons;  
    BYTE bLeftTrigger;  
    BYTE bRightTrigger;  
    SHORT sThumbLX;  
    SHORT sThumbLY;  
    SHORT sThumbRX;  
    SHORT sThumbRY;  
} XINPUT_GAMEPAD  
```

### Membros

*wButtons*\
Tipo: WORD

Máscara de bits dos botões digitais do dispositivo. Um bit definido indica que o botão correspondente está pressionado.

| Botão do dispositivo | Máscara de bits |
| - | - |
| XINPUT\_GAMEPAD\_DPAD\_UP | 0x0001 |
| XINPUT\_GAMEPAD\_DPAD\_DOWN | 0x0002 |
| XINPUT\_GAMEPAD\_DPAD\_LEFT | 0x0004 |
| XINPUT\_GAMEPAD\_DPAD\_RIGHT | 0x0008 |
| XINPUT\_GAMEPAD\_START | 0x0010 |
| XINPUT\_GAMEPAD\_BACK | 0x0020 |
| XINPUT\_GAMEPAD\_LEFT\_THUMB | 0x0040 |
| XINPUT\_GAMEPAD\_RIGHT\_THUMB | 0x0080 |
| XINPUT\_GAMEPAD\_LEFT\_SHOULDER | 0x0100 |
| XINPUT\_GAMEPAD\_RIGHT\_SHOULDER | 0x0200 |
| XINPUT\_GAMEPAD\_A | 0x1000 |
| XINPUT\_GAMEPAD\_B | 0x2000 |
| XINPUT\_GAMEPAD\_X | 0x4000 |
| XINPUT\_GAMEPAD\_Y | 0x8000 |

Os bits definidos, mas não especificados acima, são reservados, e seu estado é indefinido.

*bLeftTrigger*\
Tipo: BYTE

O valor atual do controle analógico do gatilho esquerdo. O valor está entre 0 e 255.

*bRightTrigger*\
Tipo: BYTE

O valor atual do controle analógico do gatilho direito. O valor está entre 0 e 255.

*sThumbLX*\
Tipo: SHORT

Valor do eixo x do direcional analógico esquerdo. Cada membro de eixo do direcional analógico é um valor com sinal entre -32768 e 32767 que descreve a posição do direcional analógico. Um valor 0 é centralizado, valores negativos significam para baixo ou para a esquerda, e valores positivos significam para cima ou para a direita. As constantes XINPUT\_GAMEPAD\_LEFT\_THUMB\_DEADZONE e XINPUT\_GAMEPAD\_RIGHT\_THUMB\_DEADZONE podem ser usadas como valores positivos e negativos para filtrar a entrada de um direcional analógico.

*sThumbLY*\
Tipo: SHORT

Valor do eixo y do direcional analógico esquerdo, que está entre -32768 e 32767.

*sThumbRX*\
Tipo: SHORT

Valor do eixo x do direcional analógico direito, que está entre -32768 e 32767.

*sThumbRY*\
Tipo: SHORT

Valor do eixo y do direcional analógico direito, que está entre -32768 e 32767.

## Comentários

Essa estrutura é usada pela estrutura [XINPUT\_STATE](/pt-BR/reference/input/xinputongameinput/structs/xinput_state) durante a sondagem de alterações no estado do controle.

O mapeamento específico de um botão para uma função do jogo varia de acordo com o tipo de jogo.

A constante XINPUT\_GAMEPAD\_TRIGGER\_THRESHOLD pode ser usada como o valor que *bLeftTrigger* e *bRightTrigger* devem exceder para serem registrados como pressionados. Isso é opcional, mas geralmente desejável.

## 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_GAMEPAD](/reference/input/xinputongameinput/structs/xinput_gamepad.md)
- [XINPUT_STATE](/reference/input/xinputongameinput/structs/xinput_state.md)