> ## 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_KEYSTROKE

> XINPUT_KEYSTROKE

# XINPUT\_KEYSTROKE

Décrit les données de frappe renvoyées par la fonction XInputGetKeystroke.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
typedef struct XINPUT_KEYSTROKE {  
    WORD VirtualKey;  
    WCHAR Unicode;  
    WORD Flags;  
    BYTE UserIndex;  
    BYTE HidCode;  
} XINPUT_KEYSTROKE  
```

<a id="membersSection" />

### Membres

*VirtualKey*\
Type : WORD

Code de touche virtuelle de la touche, du bouton ou du mouvement de stick.

*Unicode*\
Type : WCHAR

Ce membre n'est pas utilisé et sa valeur est zéro.

*Flags*\
Type : WORD

Indicateurs qui indiquent l'état du clavier au moment de l'événement d'entrée. Ce membre peut être n'importe quelle combinaison des indicateurs suivants :

| Valeur | Description |
| - | - |
| XINPUT\_KEYSTROKE\_KEYDOWN | La touche a été enfoncée. |
| XINPUT\_KEYSTROKE\_KEYUP | La touche a été relâchée. |
| XINPUT\_KEYSTROKE\_REPEAT | Répétition d'une touche maintenue enfoncée. |

*UserIndex*\
Type : BYTE

Index du joueur associé au casque ; valeur comprise entre 0 et `XUSER_MAX_COUNT - 1`.

*HidCode*\
Type : BYTE

Code HID (Human Interface Device) correspondant à l'entrée. S'il n'existe aucun code HID correspondant, cette valeur est zéro.

<a id="remarksSection" />

## Remarques

Cette structure est utilisée par la fonction [XInputGetKeystroke](/fr/reference/input/xinputongameinput/functions/xinputgetkeystroke).

Les futurs appareils pourraient renvoyer des codes HID et des valeurs de touches virtuelles qui ne sont pas pris en charge sur les appareils actuels et qui ne sont pas définis pour le moment. Les applications doivent ignorer ces valeurs inattendues.

Un code de touche virtuelle est une valeur d'octet qui représente une touche physique particulière du clavier, et non le ou les caractères (éventuellement aucun) auxquels la touche peut être mappée selon l'état du clavier. L'état du clavier au moment où une touche virtuelle est enfoncée modifie le caractère signalé. Par exemple, `VK_4` peut représenter « 4 » ou « \$ », selon l'état de la touche Maj.

Un événement clavier signalé comprend la touche virtuelle à l'origine de l'événement, l'indication que la touche a été enfoncée ou relâchée (ou qu'elle se répète), ainsi que l'état du clavier au moment de l'événement. L'état du clavier indique si l'une des touches Ctrl, Alt ou Maj est enfoncée.

Les codes de touches virtuelles valides (VK\_xxx) sont définis dans XInput.h. En plus des codes qui indiquent des appuis sur des touches, les codes suivants indiquent des entrées de manette :

| Valeur | Description |
| - | - |
| VK\_PAD\_A | Bouton **A** |
| VK\_PAD\_B | Bouton **B** |
| VK\_PAD\_X | Bouton **X** |
| VK\_PAD\_Y | Bouton **Y** |
| VK\_PAD\_RSHOULDER | Bouton supérieur droit |
| VK\_PAD\_LSHOULDER | Bouton supérieur gauche |
| VK\_PAD\_LTRIGGER | Gâchette gauche |
| VK\_PAD\_RTRIGGER | Gâchette droite |
| VK\_PAD\_DPAD\_UP | Pavé directionnel haut |
| VK\_PAD\_DPAD\_DOWN | Pavé directionnel bas |
| VK\_PAD\_DPAD\_LEFT | Pavé directionnel gauche |
| VK\_PAD\_DPAD\_RIGHT | Pavé directionnel droite |
| VK\_PAD\_START | Bouton Start |
| VK\_PAD\_BACK | Bouton Back |
| VK\_PAD\_LTHUMB\_PRESS | Clic du stick gauche |
| VK\_PAD\_RTHUMB\_PRESS | Clic du stick droit |
| VK\_PAD\_LTHUMB\_UP | Stick gauche vers le haut |
| VK\_PAD\_LTHUMB\_DOWN | Stick gauche vers le bas |
| VK\_PAD\_LTHUMB\_RIGHT | Stick gauche vers la droite |
| VK\_PAD\_LTHUMB\_LEFT | Stick gauche vers la gauche |
| VK\_PAD\_LTHUMB\_UPLEFT | Stick gauche vers le haut et la gauche |
| VK\_PAD\_LTHUMB\_UPRIGHT | Stick gauche vers le haut et la droite |
| VK\_PAD\_LTHUMB\_DOWNRIGHT | Stick gauche vers le bas et la droite |
| VK\_PAD\_LTHUMB\_DOWNLEFT | Stick gauche vers le bas et la gauche |
| VK\_PAD\_RTHUMB\_UP | Stick droit vers le haut |
| VK\_PAD\_RTHUMB\_DOWN | Stick droit vers le bas |
| VK\_PAD\_RTHUMB\_RIGHT | Stick droit vers la droite |
| VK\_PAD\_RTHUMB\_LEFT | Stick droit vers la gauche |
| VK\_PAD\_RTHUMB\_UPLEFT | Stick droit vers le haut et la gauche |
| VK\_PAD\_RTHUMB\_UPRIGHT | Stick droit vers le haut et la droite |
| VK\_PAD\_RTHUMB\_DOWNRIGHT | Stick droit vers le bas et la droite |
| VK\_PAD\_RTHUMB\_DOWNLEFT | Stick droit vers le bas et la gauche |

Pour plus d'informations, consultez [Le wrapper XInputOnGameInput](/fr/build/core-features/common/input/porting/input-porting-xinput#xinputWrapperSection).

<a id="requirementsSection" />

## Configuration requise

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

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

<a id="seealsoSection" />

## Voir aussi

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


## Related topics

- [XInputGetKeystroke](/fr/reference/input/xinputongameinput/functions/xinputgetkeystroke.md)
- [XInputOnGameInput](/fr/reference/input/xinputongameinput/xinputongameinput_members.md)
- [Portage de XInput vers GameInput](/fr/build/core-features/common/input/porting/input-porting-xinput.md)
- [XINPUT_GAMEPAD](/fr/reference/input/xinputongameinput/structs/xinput_gamepad.md)
- [XINPUT_CAPABILITIES](/fr/reference/input/xinputongameinput/structs/xinput_capabilities.md)