XINPUT_GAMEPAD
描述控制器的当前状态。
语法
typedef struct XINPUT_GAMEPAD {
WORD wButtons;
BYTE bLeftTrigger;
BYTE bRightTrigger;
SHORT sThumbLX;
SHORT sThumbLY;
SHORT sThumbRX;
SHORT sThumbRY;
} XINPUT_GAMEPAD
成员
wButtons
类型：WORD
设备数字按钮的位掩码。 一个设置位指示按下相应的按钮。
| 设备按钮 | 位掩码 |
|---|---|
| XINPUT_GAMEPAD_DPAD_UP | 0x0001 |
| XINPUT_GAMEPAD_DPAD_DOWN | 0x0002 |
| XINPUT_GAMEPAD_DPAD_LEFT | 0x0004 |
| XINPUT_GAMEPAD_DPAD_RIGHT | 0x0008 |
| XINPUT_GAMEPAD_START | 0x0010 |
| XINPUT_GAMEPAD_BACK | 0x0020 |
| XINPUT_GAMEPAD_LEFT_THUMB | 0x0040 |
| XINPUT_GAMEPAD_RIGHT_THUMB | 0x0080 |
| XINPUT_GAMEPAD_LEFT_SHOULDER | 0x0100 |
| XINPUT_GAMEPAD_RIGHT_SHOULDER | 0x0200 |
| XINPUT_GAMEPAD_A | 0x1000 |
| XINPUT_GAMEPAD_B | 0x2000 |
| XINPUT_GAMEPAD_X | 0x4000 |
| XINPUT_GAMEPAD_Y | 0x8000 |
已设置但未在上面定义的位将保留，并且其状态未定义。
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 用作 bLeftTrigger 和 bRightTrigger 必须大于以便在按下时注册的值。 这是可选的，但通常是期望的。
要求
头文件：XInputOnGameInput.h
支持的平台：Xbox One 系列主机和 Xbox Series 主机