XINPUT_GAMEPAD 結構 ()
描述控制器的目前狀態。
語法
typedef struct _XINPUT_GAMEPAD {
WORD wButtons;
BYTE bLeftTrigger;
BYTE bRightTrigger;
SHORT sThumbLX;
SHORT sThumbLY;
SHORT sThumbRX;
SHORT sThumbRY;
} XINPUT_GAMEPAD, *PXINPUT_GAMEPAD;
成員
wButtons
裝置數位按鈕的位掩碼，如下所示。 設定位表示已按下對應的按鈕。
| 裝置按鈕 | 位掩碼 |
|---|---|
| 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
左觸發程式類比控制項的目前值。 此值介於 0 到 255 之間。
bRightTrigger
右觸發程式類比控制元件的目前值。 此值介於 0 到 255 之間。
sThumbLX
左遊戲桿 x 軸值。 每個遊戲桿軸成員都是 -32768 與 32767 之間的帶正負號值，描述遊戲桿的位置。 值為 0 的置中。 負值表示向下或向左表示。 正值表示或向右表示。 常數XINPUT_GAMEPAD_LEFT_THUMB_DEADZONE或XINPUT_GAMEPAD_RIGHT_THUMB_DEADZONE可用來做為正值和負值，以篩選遊戲桿輸入。
sThumbLY
左遊戲桿 Y 軸值。 此值介於 -32768 和 32767 之間。
sThumbRX
右遊戲桿 x 軸值。 此值介於 -32768 和 32767 之間。
sThumbRY
右遊戲桿 Y 軸值。 此值介於 -32768 和 32767 之間。
備註
輪詢控制器狀態變更時， XINPUT_STATE 結構會使用此結構。
按鈕與遊戲函式的特定對應會根據遊戲類型而有所不同。
常數XINPUT_GAMEPAD_TRIGGER_THRESHOLD可用來做為 bLeftTrigger 和 bRightTrigger 必須大於才能登錄為按下的值。 這是選擇性的，但通常是想要的。 控制器按鈕不會指令清單交叉追蹤。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | xinput.h |