通过

XINPUT_KEYSTROKE 结构 (xinput.h)

  • 项目

指定 XInputGetKeystroke 返回的击键数据。

语法

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

成员

VirtualKey

键、按钮或摇杆移动的虚拟键代码。 有关有效虚拟密钥 (VK_xxx) 代码的列表，请参阅 XInput.h。 另请参阅备注。

Unicode

此成员未使用，值为零。

Flags

指示输入事件时键盘状态的标志。 此成员可以是以下标志的任意组合：

值 说明
XINPUT_KEYSTROKE_KEYDOWN 已按下该键。 
XINPUT_KEYSTROKE_KEYUP 密钥已释放。 
XINPUT_KEYSTROKE_REPEAT 保留密钥的重复。 

UserIndex

与设备关联的已登录玩家的索引。 可以是 0-3 范围内的值。

HidCode

对应于输入的 HID 代码。 如果没有相应的 HID 代码，则此值为零。

注解

将来的设备可能会返回当前设备上不支持且当前未定义的 HID 代码和虚拟密钥值。 应用程序应忽略这些意外值。

虚拟键代码是一个字节值，表示键盘上的特定物理键，而不是字符 (可能没有) 键可以基于键盘状态映射到。 按下虚拟键时的键盘状态会修改报告的字符。 例如，VK_4可能表示“4”或“$”，具体取决于 SHIFT 键的状态。

报告的键盘事件包括导致该事件的虚拟键、键是按下或释放 (还是重复) ，以及事件发生时键盘的状态。 键盘状态包括有关任何 CTRL、ALT 或 SHIFT 键是否关闭的信息。

例如，如果键盘事件表示 Unicode 字符 (按“A”键) ， 则 Unicode 成员将包含该字符。 否则， Unicode 将包含值零。

有效的虚拟密钥 (VK_xxx) 代码在 XInput.h 中定义。 除了指示按键的代码外，以下代码还指示控制器输入。

值 说明
VK_PAD_A 按钮
VK_PAD_B B 按钮
VK_PAD_X X 按钮
VK_PAD_Y Y 按钮
VK_PAD_RSHOULDER 右肩按钮
VK_PAD_LSHOULDER 左肩按钮
VK_PAD_LTRIGGER 左扳机键
VK_PAD_RTRIGGER 右扳机键
VK_PAD_DPAD_UP 方向盘向上
VK_PAD_DPAD_DOWN 方向盘向下
VK_PAD_DPAD_LEFT 向左方向键
VK_PAD_DPAD_RIGHT 向右方向键
VK_PAD_START “开始” 按钮
VK_PAD_BACK “后退 ”按钮
VK_PAD_LTHUMB_PRESS 左操纵杆单击
VK_PAD_RTHUMB_PRESS 右键单击操纵杆
VK_PAD_LTHUMB_UP 左操纵杆向上
VK_PAD_LTHUMB_DOWN 左操纵杆向下
VK_PAD_LTHUMB_RIGHT 左操纵杆向右
VK_PAD_LTHUMB_LEFT 左操纵杆左
VK_PAD_LTHUMB_UPLEFT 左操纵杆向上和向左
VK_PAD_LTHUMB_UPRIGHT 左操纵杆向上和向右
VK_PAD_LTHUMB_DOWNRIGHT 左操纵杆向下和向右
VK_PAD_LTHUMB_DOWNLEFT 左操纵杆向下和向左
VK_PAD_RTHUMB_UP 右操纵杆向上
VK_PAD_RTHUMB_DOWN 右操纵杆向下
VK_PAD_RTHUMB_RIGHT 右操纵杆向右
VK_PAD_RTHUMB_LEFT 右操纵杆向左
VK_PAD_RTHUMB_UPLEFT 右操纵杆向上和向左
VK_PAD_RTHUMB_UPRIGHT 右操纵杆向上和向右
VK_PAD_RTHUMB_DOWNRIGHT 右操纵杆向下和向右
VK_PAD_RTHUMB_DOWNLEFT 右操纵杆向下和向左

要求

要求 值
Header xinput.h

另请参阅

XInputGetKeystroke