> ## 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](/reference/input/xinputongameinput/structs/xinput_state) 構造体で使用されます。

ボタンとゲーム機能の具体的なマッピングは、ゲームの種類によって異なります。

定数 XINPUT\_GAMEPAD\_TRIGGER\_THRESHOLD は、押されたと判定されるために *bLeftTrigger* および *bRightTrigger* が超えている必要がある値として使用できます。これは任意ですが、多くの場合は望ましいものです。

## 要件

**ヘッダー:** XInputOnGameInput.h

**対応プラットフォーム:** XBOX One ファミリー本体および XBOX Series 本体

## 関連項目

[XInput を GameInput に移植する](/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/reference/input/xinputongameinput/xinputongameinput_members)


## Related topics

- [XINPUT_STATE](/ja-jp/reference/input/xinputongameinput/structs/xinput_state.md)
- [XInputOnGameInput](/ja-jp/reference/input/xinputongameinput/xinputongameinput_members.md)
- [XINPUT_CAPABILITIES](/ja-jp/reference/input/xinputongameinput/structs/xinput_capabilities.md)
- [XInputGetBatteryInformation](/ja-jp/reference/input/xinputongameinput/functions/xinputgetbatteryinformation.md)
- [XInputGetCapabilities](/ja-jp/reference/input/xinputongameinput/functions/xinputgetcapabilities.md)