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

旗標，指出輸入事件時的鍵盤狀態。 此成員可以是下列旗標的任何組合：

值	Description
XINPUT_KEYSTROKE_KEYDOWN	按下按鍵。
XINPUT_KEYSTROKE_KEYUP	金鑰已釋放。
XINPUT_KEYSTROKE_REPEAT	保留金鑰的重複。

UserIndex

與裝置相關聯的已登入玩家索引。 可以是範圍 0–3 中的值。

HidCode

對應至輸入的 HID 程式代碼。 如果沒有對應的 HID 程式代碼，此值為零。

備註

未來的裝置可能會傳回目前裝置不支援的 HID 代碼和虛擬機碼值，而且目前未定義。 應用程式應該忽略這些非預期的值。

虛擬按鍵程式代碼是一個字節值，代表鍵盤上的特定實體按鍵，而不是 (可能沒有任何字元) 根據鍵盤狀態來對應按鍵。 按下虛擬按鍵時鍵盤狀態會修改報告的字元。 例如，視 SHIFT 鍵的狀態而定，VK_4可能代表 「4」 或 「$」。

回報的鍵盤事件包括造成事件的虛擬按鍵、按下或放開按鍵 (或重複) ，以及在事件發生時鍵盤的狀態。 鍵盤狀態包含任何 CTRL、ALT 或 SHIFT 鍵是否關閉的相關信息。

例如，如果鍵盤事件代表 Unicode 字元 (，按下 “A” 鍵 ) ，Unicode 成員就會包含該字元。 否則， Unicode 會包含零值。

有效的虛擬金鑰 (VK_xxx) 代碼定義於 XInput.h 中。 除了指出按鍵按下的程式代碼之外，下列程式代碼還表示控制器輸入。

值	Description
VK_PAD_A	按鈕
VK_PAD_B	B 按鈕
VK_PAD_X	X 按鈕
VK_PAD_Y	Y 按鈕
VK_PAD_RSHOULDER	右手按鈕
VK_PAD_LSHOULDER	左手按鈕
VK_PAD_LTRIGGER	LT鍵
VK_PAD_RTRIGGER	RT 鍵
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	向右遊戲桿向下和向左

規格需求

需求	值
標頭	xinput.h

另請參閱

XInputGetKeystroke