Skip to main content

XINPUT_GAMEPAD

コントローラーの現在の状態を表します。

構文

メンバー

wButtons
型: WORD
デバイスのデジタル ボタンのビットマスク。ビットがセットされている場合は、対応するボタンが押されていることを示します。 セットされているものの上表で定義されていないビットは予約されており、その状態は未定義です。 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 本体

関連項目

XInput を GameInput に移植する
XInputOnGameInput
最終更新日 2026年8月24日