Share via

estrutura XINPUT_GAMEPAD (xinput.h)

  • Artigo

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

Confira também

XINPUT_STATE

Estruturas XInput

XInputGetState