XINPUT_GAMEPAD structure (xinput.h)

  • Article

Décrit l’état actuel du contrôleur.

Syntaxe

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

Membres

wButtons

Masque de bits des boutons numériques de l’appareil, comme suit. Un bit défini indique que le bouton correspondant est appuyé.

Bouton De l’appareil Masque
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
 

Les bits définis mais non définis ci-dessus sont réservés et leur état n’est pas défini.

bLeftTrigger

Valeur actuelle du contrôle analogique du déclencheur gauche. La valeur est comprise entre 0 et 255.

bRightTrigger

Valeur actuelle du contrôle analogique du déclencheur droit. La valeur est comprise entre 0 et 255.

sThumbLX

Valeur de l’axe X de la touche gauche. Chacun des membres de l’axe de la manette est une valeur signée comprise entre -32768 et 32767 décrivant la position de la manette. La valeur 0 est centrée. Les valeurs négatives indiquent vers le bas ou vers la gauche. Les valeurs positives s’inscrivent à droite ou à droite. Les constantes XINPUT_GAMEPAD_LEFT_THUMB_DEADZONE ou XINPUT_GAMEPAD_RIGHT_THUMB_DEADZONE peuvent être utilisées comme valeur positive et négative pour filtrer une entrée de la manette.

sThumbLY

Valeur de l’axe Y de la touche gauche. La valeur est comprise entre -32768 et 32767.

sThumbRX

Valeur de l’axe X de la manette droite. La valeur est comprise entre -32768 et 32767.

sThumbRY

Valeur de l’axe Y du bâton droit. La valeur est comprise entre -32768 et 32767.

Remarques

Cette structure est utilisée par la structure XINPUT_STATE lors de l’interrogation des modifications apportées à l’état du contrôleur.

Le mappage spécifique du bouton à la fonction de jeu varie en fonction du type de jeu.

La constante XINPUT_GAMEPAD_TRIGGER_THRESHOLD peut être utilisée comme valeur que bLeftTrigger et bRightTrigger doivent être supérieures à pour s’inscrire comme pressé. C’est facultatif, mais souvent souhaitable. Les boutons du contrôleur ne manifestent pas la diaphonie croisée.

Configuration requise

Condition requise Valeur
En-tête xinput.h

Voir aussi

XINPUT_STATE

XInput Structures

XInputGetState