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 本体