Share via

XINPUT_KEYSTROKE構造体 (xinput.h)

  • [アーティクル]

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

このメンバーは使用されず、値は 0 です。

Flags

入力イベント時のキーボードの状態を示すフラグ。 このメンバーは、次のフラグの任意の組み合わせにすることができます。

値 説明
XINPUT_KEYSTROKE_KEYDOWN キーが押されました。 
XINPUT_KEYSTROKE_KEYUP キーが解放されました。 
XINPUT_KEYSTROKE_REPEAT 保持されているキーの繰り返し。 

UserIndex

デバイスに関連付けられているサインインしているゲーマーのインデックス。 0 ~ 3 の範囲の値を指定できます。

HidCode

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

注釈

今後のデバイスでは、現在のデバイスではサポートされておらず、現在は未定義の HID コードと仮想キー値が返される可能性があります。 アプリケーションでは、これらの予期しない値を無視する必要があります。

仮想キー コードは、キーボードの状態に基づいてキーをマップできる文字 (存在しない場合もある) ではなく、キーボード上の特定の物理キーを表すバイト値です。 仮想キーが押された時点のキーボードの状態によって、報告された文字が変更されます。 たとえば、shift キーの状態によっては、VK_4が "4" または "$" を表している場合があります。

報告されたキーボード イベントには、イベントの原因となった仮想キー、キーが押されたか離されたか (または繰り返されている)、およびイベント時のキーボードの状態が含まれます。 キーボードの状態には、Ctrl キー、Alt キー、または Shift キーがダウンしているかどうかに関する情報が含まれます。

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

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

値 説明
VK_PAD_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 [戻る ] ボタン
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 右サムスティックを下にして左へ

要件

要件 値
Header xinput.h

こちらもご覧ください

XInputGetKeystroke