XINPUT_KEYSTROKE-Struktur (xinput.h)

Gibt von XInputGetKeystroke zurückgegebene Tastatureingabedaten an.

Syntax

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

Member

VirtualKey

Virtueller Schlüsselcode der Tasten-, Tasten- oder Stickbewegung. Eine Liste der gültigen Codes für virtuelle Schlüssel (VK_xxx) finden Sie unter XInput.h. Weitere Informationen finden Sie unter Hinweise.

Unicode

Dieser Member wird nicht verwendet, und der Wert ist null.

Flags

Flags, die den Tastaturzustand zum Zeitpunkt des Eingabeereignisses angeben. Dieser Member kann eine beliebige Kombination der folgenden Flags sein:

Wert	BESCHREIBUNG
XINPUT_KEYSTROKE_KEYDOWN	Die Taste wurde gedrückt.
XINPUT_KEYSTROKE_KEYUP	Der Schlüssel wurde freigegeben.
XINPUT_KEYSTROKE_REPEAT	Eine Wiederholung eines gehaltenen Schlüssels.

UserIndex

Index des angemeldeten Spielers, der dem Gerät zugeordnet ist. Kann ein Wert im Bereich von 0 bis 3 sein.

HidCode

HID-Code, der der Eingabe entspricht. Wenn kein entsprechender HID-Code vorhanden ist, ist dieser Wert null.

Hinweise

Zukünftige Geräte geben möglicherweise HID-Codes und Virtuelle Schlüsselwerte zurück, die auf aktuellen Geräten nicht unterstützt werden und derzeit nicht definiert sind. Anwendungen sollten diese unerwarteten Werte ignorieren.

Ein Code für virtuelle Tasten ist ein Bytewert, der eine bestimmte physische Taste auf der Tastatur darstellt, nicht die Zeichen (möglicherweise keine), denen die Taste basierend auf dem Tastaturzustand zugeordnet werden kann. Der Tastaturzustand zum Zeitpunkt des Drückens einer virtuellen Taste ändert das gemeldete Zeichen. Beispielsweise kann VK_4 je nach Zustand der UMSCHALTTASTE eine "4" oder ein "$" darstellen.

Ein gemeldetes Tastaturereignis umfasst die virtuelle Taste, die das Ereignis verursacht hat, unabhängig davon, ob die Taste gedrückt oder losgelassen wurde (oder wiederholt wird), und den Zustand der Tastatur zum Zeitpunkt des Ereignisses. Der Tastaturzustand enthält Informationen darüber, ob STRG-, ALT- oder UMSCHALTTASTEn ausgefallen sind.

Wenn das Tastaturereignis ein Unicode-Zeichen darstellt (z. B. durch Drücken der A-Taste), enthält das Unicode-Element dieses Zeichen. Andernfalls enthält Unicode den Wert Null.

Die gültigen Codes für virtuelle Schlüssel (VK_xxx) sind in XInput.h definiert. Zusätzlich zu Codes, die auf Tastendrücke hinweisen, weisen die folgenden Codes auf die Controllereingabe hin.

Wert	BESCHREIBUNG
VK_PAD_A	Eine Schaltfläche
VK_PAD_B	B-Schaltfläche
VK_PAD_X	Schaltfläche "X "
VK_PAD_Y	Schaltfläche "Y "
VK_PAD_RSHOULDER	Rechte Schultertaste
VK_PAD_LSHOULDER	Linke Schultertaste
VK_PAD_LTRIGGER	Linker Trigger
VK_PAD_RTRIGGER	Rechter Trigger
VK_PAD_DPAD_UP	Richtungspad nach oben
VK_PAD_DPAD_DOWN	Richtungspad nach unten
VK_PAD_DPAD_LEFT	Richtungspad links
VK_PAD_DPAD_RIGHT	Richtungspad rechts
VK_PAD_START	Schaltfläche "START "
VK_PAD_BACK	Schaltfläche "ZURÜCK "
VK_PAD_LTHUMB_PRESS	Klicken auf den linken Daumenstick
VK_PAD_RTHUMB_PRESS	Klicken auf den rechten Ziehpunkt
VK_PAD_LTHUMB_UP	Linker Daumenstick nach oben
VK_PAD_LTHUMB_DOWN	Linker Daumenstick nach unten
VK_PAD_LTHUMB_RIGHT	Linker Daumenstick rechts
VK_PAD_LTHUMB_LEFT	Linker Daumenstick links
VK_PAD_LTHUMB_UPLEFT	Linker Daumenstick nach oben und links
VK_PAD_LTHUMB_UPRIGHT	Linker Daumenstick nach oben und rechts
VK_PAD_LTHUMB_DOWNRIGHT	Linker Fingerstick nach unten und rechts
VK_PAD_LTHUMB_DOWNLEFT	Linker Daumenstick nach unten und links
VK_PAD_RTHUMB_UP	Rechter Ministick nach oben
VK_PAD_RTHUMB_DOWN	Rechter Ministick nach unten
VK_PAD_RTHUMB_RIGHT	Rechter Ministick nach rechts
VK_PAD_RTHUMB_LEFT	Rechter Ministick nach links
VK_PAD_RTHUMB_UPLEFT	Rechtser Daumenstick nach oben und links
VK_PAD_RTHUMB_UPRIGHT	Rechtser Ziehpunkt nach oben und rechts
VK_PAD_RTHUMB_DOWNRIGHT	Rechtser Fingerstick nach unten und rechts
VK_PAD_RTHUMB_DOWNLEFT	Rechtser Fingerstick nach unten und links

Anforderungen

Anforderung	Wert
Header	xinput.h

Weitere Informationen

XInputGetKeystroke