Skip to main content

XINPUT_KEYSTROKE

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

構文

メンバー

VirtualKey
型: WORD
キー、ボタン、またはスティック操作の仮想キー コード。 Unicode
型: WCHAR
このメンバーは使用されず、値は 0 です。 Flags
型: WORD
入力イベント発生時のキーボードの状態を示すフラグ。このメンバーは次のフラグの任意の組み合わせを取ります。 UserIndex
型: BYTE
ヘッドセットに関連付けられているゲーマーのインデックス。0 ~ XUSER_MAX_COUNT - 1 の範囲の値。 HidCode
型: BYTE
入力に対応する Human Interface Device (HID) コード。対応する HID コードがない場合、この値は 0 です。

解説

この構造体は XInputGetKeystroke 関数で使用されます。 将来のデバイスでは、現在のデバイスではサポートされておらず、現時点では定義されていない HID コードや仮想キー値が返される場合があります。アプリケーションは、これらの予期しない値を無視する必要があります。 仮想キー コードは、キーボード上の特定の物理キーを表すバイト値であり、キーボードの状態に応じてマップされる文字 (存在しない場合もあります) ではありません。仮想キーが押された時点のキーボードの状態が、報告される文字を変化させます。たとえば、VK_4 は Shift キーの状態に応じて「4」または「$」を表すことがあります。 報告されるキーボード イベントには、イベントの原因となった仮想キー、キーが押されたか離されたか (またはリピートしているか)、およびイベント発生時のキーボードの状態が含まれます。キーボードの状態は、Ctrl、Alt、または Shift のいずれかのキーが押されているかどうかを示します。 有効な仮想キー コード (VK_xxx) は XInput.h で定義されています。キー押下を示すコードに加えて、次のコードはコントローラー入力を示します。 詳細については、XInputOnGameInput ラッパーを参照してください。

要件

ヘッダー: XInputOnGameInput.h 対応プラットフォーム: XBOX One ファミリー本体および XBOX Series 本体

関連項目

XInput から GameInput への移植
XInputOnGameInput
最終更新日 2026年8月24日