Skip to main content

XINPUT_GAMEPAD

描述控制器的当前状态。

语法

成员

wButtons
类型:WORD
设备数字按钮的位掩码。位设置为 1 表示相应按钮被按下。 上文未定义但被设置的位为保留位,其状态未定义。 bLeftTrigger
类型:BYTE
左扳机模拟控件的当前值。取值介于 0 到 255 之间。 bRightTrigger
类型:BYTE
右扳机模拟控件的当前值。取值介于 0 到 255 之间。 sThumbLX
类型:SHORT
左摇杆的 X 轴值。每个摇杆轴成员均为介于 -32768 到 32767 之间的有符号值,用于描述摇杆的位置。值为 0 表示居中,负值表示向下或向左,正值表示向上或向右。常量 XINPUT_GAMEPAD_LEFT_THUMB_DEADZONE 和 XINPUT_GAMEPAD_RIGHT_THUMB_DEADZONE 可作为正负值用于过滤摇杆输入。 sThumbLY
类型:SHORT
左摇杆的 Y 轴值,介于 -32768 到 32767 之间。 sThumbRX
类型:SHORT
右摇杆的 X 轴值,介于 -32768 到 32767 之间。 sThumbRY
类型:SHORT
右摇杆的 Y 轴值,介于 -32768 到 32767 之间。

备注

在轮询控制器状态变化期间,此结构由 XINPUT_STATE 结构使用。 按钮到游戏功能的具体映射因游戏类型而异。 常量 XINPUT_GAMEPAD_TRIGGER_THRESHOLD 可用作 bLeftTriggerbRightTrigger 必须超过的阈值,方可视为按下。此为可选,但通常是可取的。

要求

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

另请参阅

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