> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XINPUT_GAMEPAD

> XINPUT_GAMEPAD

# XINPUT\_GAMEPAD

描述控制器的目前狀態。

## 語法

```cpp theme={null}
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](/zh-TW/reference/input/xinputongameinput/structs/xinput_state) 結構在輪詢控制器狀態變更期間使用。

按鈕與遊戲功能的特定對應方式，會因遊戲類型而異。

常數 XINPUT\_GAMEPAD\_TRIGGER\_THRESHOLD 可作為 *bLeftTrigger* 和 *bRightTrigger* 必須大於才會登錄為按下的值。這是選擇性的，但通常很實用。

## 需求

**標頭：** XInputOnGameInput.h

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[將 XInput 移植到 GameInput](/zh-TW/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/zh-TW/reference/input/xinputongameinput/xinputongameinput_members)


## Related topics

- [XINPUT_GAMEPAD](/reference/input/xinputongameinput/structs/xinput_gamepad.md)
- [XINPUT_STATE](/reference/input/xinputongameinput/structs/xinput_state.md)