estrutura XINPUT_GAMEPAD (xinput.h)
Descreve o estado atual do controlador.
Sintaxe
typedef struct _XINPUT_GAMEPAD {
WORD wButtons;
BYTE bLeftTrigger;
BYTE bRightTrigger;
SHORT sThumbLX;
SHORT sThumbLY;
SHORT sThumbRX;
SHORT sThumbRY;
} XINPUT_GAMEPAD, *PXINPUT_GAMEPAD;
Membros
wButtons
Bitmask dos botões digitais do dispositivo, da seguinte maneira. Um bit definido indica que o botão correspondente é pressionado.
| Botão Dispositivo | Bitmask |
|---|---|
| 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 definidos acima, são reservados e seu estado é indefinido.
bLeftTrigger
O valor atual do controle analógico do gatilho esquerdo. O valor está entre 0 e 255.
bRightTrigger
O valor atual do controle analógico do gatilho direito. O valor está entre 0 e 255.
sThumbLX
Valor do eixo x do botão esquerdo. Cada um dos membros do eixo dos polegares é um valor assinado entre -32768 e 32767 que descreve a posição do botão. Um valor de 0 é centralizado. Valores negativos significam para baixo ou para a esquerda. Valores positivos significam para cima ou para a direita. As constantes XINPUT_GAMEPAD_LEFT_THUMB_DEADZONE ou XINPUT_GAMEPAD_RIGHT_THUMB_DEADZONE podem ser usadas como um valor positivo e negativo para filtrar uma entrada de thumbstick.
sThumbLY
Valor do eixo y do botão esquerdo. O valor está entre -32768 e 32767.
sThumbRX
Valor do eixo x do botão direito. O valor está entre -32768 e 32767.
sThumbRY
Valor do eixo y do botão direito. O valor está entre -32768 e 32767.
Comentários
Essa estrutura é usada pela estrutura XINPUT_STATE ao sondar alterações no estado do controlador.
O mapeamento específico da função de botão para jogo varia dependendo do tipo de jogo.
A constante XINPUT_GAMEPAD_TRIGGER_THRESHOLD pode ser usada como o valor que bLeftTrigger e bRightTrigger devem ser maiores do que registrar conforme pressionado. Isso é opcional, mas geralmente desejável. Os botões do controlador não manifestam crosstalk.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | xinput.h |