estructura XINPUT_GAMEPAD (xinput.h)

  • Artículo

Describe el estado actual del controlador.

Sintaxis

typedef struct _XINPUT_GAMEPAD {
  WORD  wButtons;
  BYTE  bLeftTrigger;
  BYTE  bRightTrigger;
  SHORT sThumbLX;
  SHORT sThumbLY;
  SHORT sThumbRX;
  SHORT sThumbRY;
} XINPUT_GAMEPAD, *PXINPUT_GAMEPAD;

Miembros

wButtons

Máscara de bits de los botones digitales del dispositivo, como se indica a continuación. Un bit establecido indica que se presiona el botón correspondiente.

Botón Dispositivo Máscara
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
 

Los bits establecidos pero no definidos anteriormente están reservados y su estado no está definido.

bLeftTrigger

Valor actual del control analógico del desencadenador izquierdo. El valor está comprendido entre 0 y 255.

bRightTrigger

Valor actual del control analógico del desencadenador derecho. El valor está comprendido entre 0 y 255.

sThumbLX

Valor del eje X del stick analógico izquierdo. Cada uno de los miembros del eje de la barra digital es un valor con signo entre -32768 y 32767 que describe la posición del stick analógico. Un valor de 0 está centrado. Los valores negativos indican hacia abajo o hacia la izquierda. Los valores positivos se suscriben o a la derecha. Las constantes XINPUT_GAMEPAD_LEFT_THUMB_DEADZONE o XINPUT_GAMEPAD_RIGHT_THUMB_DEADZONE se pueden usar como un valor positivo y negativo para filtrar una entrada de stick analógico.

sThumbLY

Valor del eje Y del stick analógico izquierdo. El valor está comprendido entre -32768 y 32767.

sThumbRX

Valor del eje x del stick analógico derecho. El valor está comprendido entre -32768 y 32767.

sThumbRY

Valor del eje y del stick analógico derecho. El valor está comprendido entre -32768 y 32767.

Comentarios

La estructura XINPUT_STATE usa esta estructura al sondear los cambios en el estado del controlador.

La asignación específica del botón a la función de juego varía según el tipo de juego.

La constante XINPUT_GAMEPAD_TRIGGER_THRESHOLD se puede usar como valor que bLeftTrigger y bRightTrigger deben ser mayores que para registrarse como presionado. Esto es opcional, pero a menudo deseable. Los botones del controlador no manifiestan la comunicación cruzada.

Requisitos

Requisito Valor
Header xinput.h

Consulte también

XINPUT_STATE

Estructuras XInput

XInputGetState