Skip to main content

XINPUT_KEYSTROKE

描述 XInputGetKeystroke 函数返回的击键数据。

语法

成员

VirtualKey
类型:WORD
按键、按钮或摇杆动作的虚拟键代码。 Unicode
类型:WCHAR
此成员未使用,其值为零。 Flags
类型:WORD
指示输入事件发生时键盘状态的标志。此成员可为以下标志的任意组合: UserIndex
类型:BYTE
与耳机关联的玩家索引;取值范围为 0 到 XUSER_MAX_COUNT - 1 HidCode
类型:BYTE
与输入对应的人机接口设备 (HID) 代码。如果没有对应的 HID 代码,则此值为零。

备注

此结构由 XInputGetKeystroke 函数使用。 未来的设备可能会返回当前设备不支持且此时尚未定义的 HID 代码和虚拟键值。应用程序应忽略这些意外值。 虚拟键代码是一个字节值,表示键盘上特定的物理按键,而不是根据键盘状态可以映射到的字符(可能没有)。按下虚拟键时的键盘状态会修改所报告的字符。例如,VK_4 可能表示 “4” 或 ”$“,具体取决于 Shift 键的状态。 报告的键盘事件包括引起事件的虚拟键、按键是被按下还是被释放(或正在重复)以及事件发生时的键盘状态。键盘状态指示是否按下了任何 Ctrl、Alt 或 Shift 键。 有效的虚拟键代码 (VK_xxx) 在 XInput.h 中定义。除了指示按键按下的代码之外,以下代码指示控制器输入: 有关详细信息,请参阅 XInputOnGameInput 包装器

要求

头文件: XInputOnGameInput.h 支持的平台: XBOX One 系列主机和 XBOX Series 主机

另请参阅

从 XInput 移植到 GameInput
XInputOnGameInput
最后修改于 2026年8月24日