Skip to main content

XINPUT_KEYSTROKE

描述 XInputGetKeystroke 函式傳回的按鍵輸入資料。

語法

成員

VirtualKey
類型:WORD
按鍵、按鈕或搖桿移動的虛擬按鍵碼。 Unicode
類型:WCHAR
未使用此成員,其值為零。 Flags
類型:WORD
指出輸入事件發生時鍵盤狀態的旗標。此成員可以是下列旗標的任意組合: UserIndex
類型:BYTE
與耳機相關聯之玩家的索引;值的範圍為 0 到 XUSER_MAX_COUNT - 1。 HidCode
類型:BYTE
對應至輸入的人性化介面裝置 (HID) 代碼。如果沒有對應的 HID 代碼,此值為零。

備註

此結構由 XInputGetKeystroke 函式使用。 未來的裝置可能會傳回目前裝置不支援且目前尚未定義的 HID 代碼和虛擬按鍵值。應用程式應忽略這些非預期的值。 虛擬按鍵碼是一個位元組值,代表鍵盤上特定的實體按鍵,而不是該按鍵根據鍵盤狀態可對應的一或多個字元 (可能沒有)。按下虛擬按鍵時的鍵盤狀態會修改所回報的字元。例如,VK_4 可能代表 “4” 或 ”$“,取決於 Shift 鍵的狀態。 回報的鍵盤事件包括造成事件的虛擬按鍵、按鍵是按下或放開 (或正在重複),以及事件發生時的鍵盤狀態。鍵盤狀態會指出是否按下任何 Ctrl、Alt 或 Shift 鍵。 有效的虛擬按鍵碼 (VK_xxx) 定義於 XInput.h 中。除了表示按鍵按下的代碼之外,下列代碼表示控制器輸入: 如需詳細資訊,請參閱 XInputOnGameInput 包裝函式。

需求

標頭: XInputOnGameInput.h 支援的平台: XBOX One 系列主機和 XBOX Series 主機

另請參閱

從 XInput 移植到 GameInput
XInputOnGameInput
Last modified on October 6, 2026