XINPUT_GAMEPAD 構造体 (xinput.h)
コントローラーの現在の状態について説明します。
構文
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 を押された状態で登録するよりも大きくする必要がある値として使用できます。 これは省略可能ですが、多くの場合、望ましいです。 コントローラー ボタンはクロストークをマニフェストしません。
要件
| 要件 | 値 |
|---|---|
| Header | xinput.h |