XINPUT_KEYSTROKE

  • [アーティクル]

XInputGetKeystroke によって返されるキーストローク データを指定します。

typedef struct _XINPUT_KEYSTROKE {
    WORD VirtualKey;
    WCHAR Unicode;
    WORD Flags;
    BYTE UserIndex;
    BYTE HidCode;
} XINPUT_KEYSTROKE, *PXINPUT_KEYSTROKE;

メンバ

  • VirtualKey
    キー、ボタン、またはスティックの動作を表す仮想キー コードです。有効な仮想キー コード (VK_xxx) については、XInput.h を参照してください。以下の「解説」も参照してください。

  • Unicode
    このメンバーは未使用であり、値はゼロです。

  • Flags
    入力イベントが発生したときのキーボードの状態を表すフラグです。メンバーは以下のフラグの組み合わせです。

    値説明
    XINPUT_KEYSTROKE_KEYDOWNキーが押されました。
    XINPUT_KEYSTROKE_KEYUPキーが離されました。
    XINPUT_KEYSTROKE_REPEATキーが押されたままで、押下を反復している状態です。

  • UserIndex
    デバイスに関連するログインしたゲーマーのインデックス (0 ～ 3) です。値は、0 ～ 3 の範囲内でなければなりません。

  • HidCode
    入力に対応する HID コードです。対応する HID コードがない場合、この値は 0 です。

解説　

仮想キー コードは、キーボード上の物理的な各キーを表すバイト値であり、キーボードの状態に基づいてキーにマップされる 1 文字または複数の文字 (マップされない文字もありますが) のことではありません。どの文字が報告されるかは、仮想キーが押された時点でのキーボードの状態によって異なります。たとえば、VK_4 は、Shift キーの状態によって、"4" または "$" を表します。

キーボード イベントが報告されるときには、イベントを発生させた仮想キー、キーが押されたのか離されたのか (または反復)、およびイベント発生時のキーボードの状態も通知されます。キーボードの状態には、Ctrl キー、Alt キー、または Shift キーが押されているかどうかに関する情報も含まれます。

キーボード イベントが Unicode 文字を表している場合 (たとえば "A" キーが押されている場合)、Unicode メンバーにはその文字が設定されます。それ以外は、Unicode には 0 が設定されます。

有効な仮想キー コード (VK_xxx) は、XInput.h に定義されています。キーの押下を示すコードに加えて、次のコードがコントローラー入力を示します。

値説明
VK_PAD_AA ボタン
VK_PAD_BB ボタン
VK_PAD_XX ボタン
VK_PAD_YY ボタン
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_STARTSTART ボタン
VK_PAD_BACKBACK ボタン
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右サムスティックの下方向および左方向

要件

ヘッダー: XInput.h 宣言

関連項目

XInputGetKeystroke