> ## 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 retourné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 du joystick.

*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 toute 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 de périphérique d'interface humaine (HID) qui correspond à 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-CA/reference/input/xinputongameinput/functions/xinputgetkeystroke).

Les appareils futurs pourraient retourner des codes HID et des valeurs de touches virtuelles qui ne sont pas pris en charge par 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'un 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 associé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 de clavier signalé comprend la touche virtuelle qui a causé l'événement, si la touche a été enfoncée ou relâchée (ou si elle se répète), et l'état du clavier au moment de l'événement. L'état du clavier indique si une touche 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 pressions de touches, les codes suivants indiquent des entrées de la 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 vers le haut |
| VK\_PAD\_DPAD\_DOWN | Pavé directionnel vers le bas |
| VK\_PAD\_DPAD\_LEFT | Pavé directionnel vers la gauche |
| VK\_PAD\_DPAD\_RIGHT | Pavé directionnel vers la droite |
| VK\_PAD\_START | Bouton Start |
| VK\_PAD\_BACK | Bouton Back |
| VK\_PAD\_LTHUMB\_PRESS | Clic du joystick gauche |
| VK\_PAD\_RTHUMB\_PRESS | Clic du joystick droit |
| VK\_PAD\_LTHUMB\_UP | Joystick gauche vers le haut |
| VK\_PAD\_LTHUMB\_DOWN | Joystick gauche vers le bas |
| VK\_PAD\_LTHUMB\_RIGHT | Joystick gauche vers la droite |
| VK\_PAD\_LTHUMB\_LEFT | Joystick gauche vers la gauche |
| VK\_PAD\_LTHUMB\_UPLEFT | Joystick gauche vers le haut et la gauche |
| VK\_PAD\_LTHUMB\_UPRIGHT | Joystick gauche vers le haut et la droite |
| VK\_PAD\_LTHUMB\_DOWNRIGHT | Joystick gauche vers le bas et la droite |
| VK\_PAD\_LTHUMB\_DOWNLEFT | Joystick gauche vers le bas et la gauche |
| VK\_PAD\_RTHUMB\_UP | Joystick droit vers le haut |
| VK\_PAD\_RTHUMB\_DOWN | Joystick droit vers le bas |
| VK\_PAD\_RTHUMB\_RIGHT | Joystick droit vers la droite |
| VK\_PAD\_RTHUMB\_LEFT | Joystick droit vers la gauche |
| VK\_PAD\_RTHUMB\_UPLEFT | Joystick droit vers le haut et la gauche |
| VK\_PAD\_RTHUMB\_UPRIGHT | Joystick droit vers le haut et la droite |
| VK\_PAD\_RTHUMB\_DOWNRIGHT | Joystick droit vers le bas et la droite |
| VK\_PAD\_RTHUMB\_DOWNLEFT | Joystick droit vers le bas et la gauche |

Pour plus d'informations, consultez [Le wrapper XInputOnGameInput](/fr-CA/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 d'XInput vers GameInput](/fr-CA/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/fr-CA/reference/input/xinputongameinput/xinputongameinput_members)


## Related topics

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