structure XINPUT_KEYSTROKE (xinput.h)

Spécifie les données de frappe retournées par XInputGetKeystroke.

Syntaxe

typedef struct _XINPUT_KEYSTROKE {
  WORD  VirtualKey;
  WCHAR Unicode;
  WORD  Flags;
  BYTE  UserIndex;
  BYTE  HidCode;
} XINPUT_KEYSTROKE, *PXINPUT_KEYSTROKE;

Membres

VirtualKey

Code de clé virtuelle de la touche, du bouton ou du mouvement du stick. Consultez XInput.h pour obtenir la liste des codes de clé virtuelle (VK_xxx) valides. Consultez également Remarques.

Unicode

Ce membre n’est pas utilisé et la valeur est égale à zéro.

Flags

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 clé a été libérée.
XINPUT_KEYSTROKE_REPEAT	Répétition d’une clé conservée.

UserIndex

Index du joueur connecté associé à l’appareil. Il peut s’agir d’une valeur comprise entre 0 et 3.

HidCode

Code HID correspondant à l’entrée. S’il n’existe aucun code HID correspondant, cette valeur est égale à zéro.

Remarques

Les appareils futurs peuvent retourner des codes HID et des valeurs de clé virtuelle qui ne sont pas pris en charge sur les appareils actuels et qui ne sont actuellement pas définis. Les applications doivent ignorer ces valeurs inattendues.

Un code de clé virtuelle est une valeur d’octet qui représente une touche physique particulière sur le clavier, et non le caractère ou les caractères ( peut-être aucun) auxquels la touche peut être mappée en fonction de 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 un « 4 » ou un « $ », selon l’état de la touche MAJ.

Un événement de clavier signalé inclut la touche virtuelle à l’origine de l’événement, si la touche a été enfoncée ou relâchée (ou se répète) et l’état du clavier au moment de l’événement. L’état du clavier inclut des informations indiquant si les touches CTRL, ALT ou MAJ sont arrêtées.

Si l’événement de clavier représente un caractère Unicode (par exemple, en appuyant sur la touche « A »), le membre Unicode contient ce caractère. Sinon, Unicode contiendra la valeur zéro.

Les codes de clé virtuelle (VK_xxx) valides sont définis dans XInput.h. En plus des codes qui indiquent des appuis sur la touche, les codes suivants indiquent l’entrée du contrôleur.

Valeur	Description
VK_PAD_A	Bouton
VK_PAD_B	Bouton B
VK_PAD_X	Bouton X
VK_PAD_Y	Bouton Y
VK_PAD_RSHOULDER	Épaule droite
VK_PAD_LSHOULDER	Épaule 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 gauche
VK_PAD_DPAD_RIGHT	Pavé directionnel vers la droite
VK_PAD_START	Bouton DÉMARRER
VK_PAD_BACK	Bouton PRÉCÉDENT
VK_PAD_LTHUMB_PRESS	Cliquez sur la touche gauche
VK_PAD_RTHUMB_PRESS	Cliquez sur le bouton droit
VK_PAD_LTHUMB_UP	Baguette gauche vers le haut
VK_PAD_LTHUMB_DOWN	Baguette gauche vers le bas
VK_PAD_LTHUMB_RIGHT	Stick gauche droite
VK_PAD_LTHUMB_LEFT	Touche gauche gauche
VK_PAD_LTHUMB_UPLEFT	Baguette gauche vers le haut et la gauche
VK_PAD_LTHUMB_UPRIGHT	Baguette gauche vers le haut et vers la droite
VK_PAD_LTHUMB_DOWNRIGHT	Touche gauche vers le bas et la droite
VK_PAD_LTHUMB_DOWNLEFT	Baguette gauche vers le bas et la gauche
VK_PAD_RTHUMB_UP	Stick analogique droit vers le haut
VK_PAD_RTHUMB_DOWN	Stick analogique droit vers le bas
VK_PAD_RTHUMB_RIGHT	Stick analogique droit vers la droite
VK_PAD_RTHUMB_LEFT	Stick analogique droit vers la gauche
VK_PAD_RTHUMB_UPLEFT	Bâton droit vers le haut et vers la gauche
VK_PAD_RTHUMB_UPRIGHT	Bâton droit vers le haut et vers la droite
VK_PAD_RTHUMB_DOWNRIGHT	Bâton droit vers le bas et vers la droite
VK_PAD_RTHUMB_DOWNLEFT	Bâton droit vers le bas et la gauche

Configuration requise

Condition requise	Valeur
En-tête	xinput.h

Voir aussi

XInputGetKeystroke