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 |