XINPUT_KEYSTROKE
XInputGetKeystroke 関数によって返されるキーストローク データについて説明します。
構文
typedef struct XINPUT_KEYSTROKE {
WORD VirtualKey;
WCHAR Unicode;
WORD Flags;
BYTE UserIndex;
BYTE HidCode;
} XINPUT_KEYSTROKE
メンバー
VirtualKey
型: WORD
キー、ボタン、またはスティックの移動の仮想キー コード。
Unicode
型: WCHAR
このメンバーは使用されません。値は 0 です。
Flags
型: WORD
入力イベント時のキーボードの状態を示すフラグ。 このメンバーは、以下のフラグの組み合わせになります。
| 値 | 説明 |
|---|---|
| XINPUT_KEYSTROKE_KEYDOWN | キーが押されました。 |
| XINPUT_KEYSTROKE_KEYUP | キーが放されました。 |
| XINPUT_KEYSTROKE_REPEAT | 保持されているキーの繰り返し。 |
UserIndex
型: BYTE
ヘッドセットに関連付けられたゲーマーのインデックス。0 ～ XUSER_MAX_COUNT - 1 の範囲の値です。
HidCode
型: BYTE
入力に対応するヒューマン インターフェイス デバイス (HID) コードです。 対応する HID コードがない場合、この値は 0 です。
解説
この構造体は、XInputGetKeystroke 関数によって使用されます。
将来のデバイスは、現在のデバイスでサポートされていない、現在未定義の HID コードと仮想キー値を返す場合があります。 アプリケーションは、これらの予期しない値を無視する必要があります。
仮想キー コードは、キーボードの特定の物理キーを表すバイト値です。キーボードの状態に従ってキーをマッピングできる 1 つまたは複数の文字 (ない場合もあります) ではありません。 仮想キーが押されたときのキーボードの状態により、報告される文字が変更されます。 たとえば、VK_4 は、[Shift] キーの状態に応じて、「4」または「$」を表す場合があります。
報告されるキーボード イベントには、イベントを発生させた仮想キー、キーが押されたか、放されたか (または繰り返えされたか)、イベント発生時のキーボードの状態が含まれます。 キーボードの状態では、[Ctrl]、[Alt]、または [Shift] キーが押されているかどうかが示されます。
有効な仮想キー コード (VK_xxx) のコードは XInput.h で定義されています。 キーの押下を示すコードに加えて、次のコードはコントローラー入力を示しています。
| 値 | 説明 |
|---|---|
| VK_PAD_A | A ボタン |
| VK_PAD_B | B ボタン |
| VK_PAD_X | X ボタン |
| VK_PAD_Y | Y ボタン |
| VK_PAD_RSHOULDER | 右ショルダー ボタン |
| VK_PAD_LSHOULDER | 左ショルダー ボタン |
| VK_PAD_LTRIGGER | 左トリガー |
| VK_PAD_RTRIGGER | 右トリガー |
| VK_PAD_DPAD_UP | 方向パッドの上ボタン |
| VK_PAD_DPAD_DOWN | 方向パッドの下ボタン |
| VK_PAD_DPAD_LEFT | 方向パッドの左ボタン |
| VK_PAD_DPAD_RIGHT | 方向パッドの右ボタン |
| VK_PAD_START | [スタート] ボタン |
| VK_PAD_BACK | BACK ボタン |
| VK_PAD_LTHUMB_PRESS | 左サム スティック クリック |
| VK_PAD_RTHUMB_PRESS | 右サム スティック クリック |
| VK_PAD_LTHUMB_UP | 左サム スティック上 |
| VK_PAD_LTHUMB_DOWN | 左サム スティック下 |
| VK_PAD_LTHUMB_RIGHT | 左サム スティック右 |
| VK_PAD_LTHUMB_LEFT | 左サム スティック左 |
| VK_PAD_LTHUMB_UPLEFT | 左サム スティック上と左 |
| VK_PAD_LTHUMB_UPRIGHT | 左サム スティック上と右 |
| VK_PAD_LTHUMB_DOWNRIGHT | 左サム スティック下と右 |
| VK_PAD_LTHUMB_DOWNLEFT | 左サム スティック下と左 |
| VK_PAD_RTHUMB_UP | 右サム スティック上 |
| VK_PAD_RTHUMB_DOWN | 右サム スティック下 |
| VK_PAD_RTHUMB_RIGHT | 右サム スティック右 |
| VK_PAD_RTHUMB_LEFT | 右サム スティック左 |
| VK_PAD_RTHUMB_UPLEFT | 右サム スティック上と左 |
| VK_PAD_RTHUMB_UPRIGHT | 右サム スティック上と右 |
| VK_PAD_RTHUMB_DOWNRIGHT | 右サム スティック下と右 |
| VK_PAD_RTHUMB_DOWNLEFT | 右サムスティック下と左 |
詳細については、「The XInputOnGameInput ラッパー」を参照してください。
要件
ヘッダー: XInputOnGameInput.h
サポートされているプラットフォーム: Xbox One ファミリー本体、Xbox Series 本体