> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XINPUT_GAMEPAD

> XINPUT_GAMEPAD

# XINPUT\_GAMEPAD

Décrit l'état actuel de la manette.

## Syntaxe

```cpp theme={null}
typedef struct XINPUT_GAMEPAD {  
    WORD wButtons;  
    BYTE bLeftTrigger;  
    BYTE bRightTrigger;  
    SHORT sThumbLX;  
    SHORT sThumbLY;  
    SHORT sThumbRX;  
    SHORT sThumbRY;  
} XINPUT_GAMEPAD  
```

### Membres

*wButtons*\
Type : WORD

Masque de bits des boutons numériques de l'appareil. Un bit défini indique que le bouton correspondant est enfoncé.

| Bouton de l'appareil | Masque de bits |
| - | - |
| 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 qui ne figurent pas ci-dessus sont réservés, et leur état n'est pas défini.

*bLeftTrigger*\
Type : BYTE

Valeur actuelle de la commande analogique de la gâchette gauche. La valeur est comprise entre 0 et 255.

*bRightTrigger*\
Type : BYTE

Valeur actuelle de la commande analogique de la gâchette droite. La valeur est comprise entre 0 et 255.

*sThumbLX*\
Type : SHORT

Valeur de l'axe x du joystick gauche. Chaque membre d'axe de joystick est une valeur signée comprise entre -32768 et 32767 qui décrit la position du joystick. Une valeur de 0 correspond au centre, les valeurs négatives signifient vers le bas ou vers la gauche, et les valeurs positives signifient vers le haut ou vers la droite. Les constantes XINPUT\_GAMEPAD\_LEFT\_THUMB\_DEADZONE et XINPUT\_GAMEPAD\_RIGHT\_THUMB\_DEADZONE peuvent être utilisées comme valeurs positives et négatives pour filtrer une entrée de joystick.

*sThumbLY*\
Type : SHORT

Valeur de l'axe y du joystick gauche, comprise entre -32768 et 32767.

*sThumbRX*\
Type : SHORT

Valeur de l'axe x du joystick droit, comprise entre -32768 et 32767.

*sThumbRY*\
Type : SHORT

Valeur de l'axe y du joystick droit, comprise entre -32768 et 32767.

## Remarques

Cette structure est utilisée par la structure [XINPUT\_STATE](/fr-CA/reference/input/xinputongameinput/structs/xinput_state) lors de l'interrogation des changements d'état de la manette.

L'association précise d'un bouton à une fonction de jeu varie selon le type de jeu.

La constante XINPUT\_GAMEPAD\_TRIGGER\_THRESHOLD peut servir de valeur que *bLeftTrigger* et *bRightTrigger* doivent dépasser pour être considérées comme enfoncées. C'est facultatif, mais souvent souhaitable.

## Configuration requise

**En-tête :** XInputOnGameInput.h

**Plateformes prises en charge :** consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[Porter XInput vers GameInput](/fr-CA/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/fr-CA/reference/input/xinputongameinput/xinputongameinput_members)


## Related topics

- [XINPUT_GAMEPAD](/reference/input/xinputongameinput/structs/xinput_gamepad.md)
- [XINPUT_STATE](/reference/input/xinputongameinput/structs/xinput_state.md)