XINPUT_GAMEPAD structure (xinput.h)
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 |