XInputGetKeystroke
擷取控制器輸入事件。語法
參數
dwUserIndex _In_類型：DWORD 與裝置相關聯之已登入玩家的索引。值的範圍為 0-XUSER_MAX_COUNT 到 1；XUSER_INDEX_ANY 用於從任何使用者擷取下一個可用的輸入事件。 dwReserved
類型：Reserved 未使用此參數。 pKeystroke _Out_
類型：XINPUT_KEYSTROKE* 指向接收輸入事件之 XINPUT_KEYSTROKE 結構的指標。
傳回值
類型：DWORD- 如果函式成功，會傳回 ERROR_SUCCESS。
- 如果未按下任何新按鍵，函式會傳回 ERROR_EMPTY。
- 如果控制器未連接或使用者尚未啟用控制器，函式會傳回 ERROR_DEVICE_NOT_CONNECTED；請參閱下方的「備註」一節。
- 如果函式失敗，會傳回 Winerror.h 中定義的錯誤碼。
備註
系統啟動時，無線控制器不會被視為作用中；如果在無線控制器變成作用中之前呼叫任何 XInput 函式，該呼叫會傳回 ERROR_DEVICE_NOT_CONNECTED。遊戲必須檢查傳回碼，並且必須準備好處理此狀況。有線控制器在插入時會自動啟用。無線控制器會在使用者按下 START 或 Guide 按鈕開啟控制器時啟用。 如果您要從 XInput 移植到 GameInput 的程式碼未呼叫 GetKeyStroke 函式，則可以定義 XINPUT_ON_GAMEINPUT_NO_XINPUTGETKEYSTROKE 來縮減 XInput 包裝函式的大小。如需詳細資訊，請參閱從 XInput 移植到 GameInput。需求
標頭： XInputOnGameInput.h 程式庫： xgameruntime.lib 支援的平台： XBOX One 系列主機和 XBOX Series 主機另請參閱
將 XInput 移植到 GameInputXInputOnGameInput