> ## 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 mais non répertoriés ci-dessus sont réservés et leur état est indéfini.

*bLeftTrigger*\
Type : BYTE

Valeur actuelle du contrôle analogique de la gâchette gauche. La valeur est comprise entre 0 et 255.

*bRightTrigger*\
Type : BYTE

Valeur actuelle du contrôle analogique de la gâchette droite. La valeur est comprise entre 0 et 255.

*sThumbLX*\
Type : SHORT

Valeur de l'axe x du stick gauche. Chaque membre d'axe de stick est une valeur signée comprise entre -32768 et 32767 qui décrit la position du stick. Une valeur de 0 correspond à la position centrale, 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 stick.

*sThumbLY*\
Type : SHORT

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

*sThumbRX*\
Type : SHORT

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

*sThumbRY*\
Type : SHORT

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

## Remarques

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

Le mappage spécifique d'un bouton à une fonction de jeu varie selon le type de jeu.

La constante XINPUT\_GAMEPAD\_TRIGGER\_THRESHOLD peut être utilisée comme valeur que *bLeftTrigger* et *bRightTrigger* doivent dépasser pour être considérées comme enfoncées. Cela 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/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/fr/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)