XInputEnable
設定 XInput 的回報狀態。語法
參數
enable _In_類型:BOOL 如果 enable 為 FALSE,XInput 只會傳送中性資料以回應 XInputGetState:也就是所有按鈕放開、軸置中,且扳機為 0。XInputSetState 呼叫會被登錄,但不會傳送至裝置。傳送 FALSE 以外的任何值,都會將讀取和寫入功能還原為正常狀態。
傳回值
類型:void 無。備註
此函式已淘汰,不應寫入任何新程式碼中。XInputEnable 會增加許多 XInput 包裝函式呼叫的額外負荷。您可以#define XINPUT_ON_GAMEINPUT_NO_XINPUTENABLE 以移除 XInputEnable 及其產生的額外負荷。如需詳細資訊,請參閱從 XInput 移植到 GameInput。
此函式應在應用程式取得或失去焦點時呼叫。使用此函式時,您不必變更應用程式中的 XInput 查詢迴圈,因為停用 XInput 時一律會回報中性資料。
在支援震動效果的控制器中:
- 傳遞 FALSE 會停止目前正在播放的任何震動效果。在此狀態下,對 XInputSetState 的呼叫會被登錄,但不會傳遞至裝置。
- 傳遞 TRUE 會將傳送至 XInputSetState 的最後一個震動要求 (即使為 0) 傳遞至裝置。
需求
標頭: XInputOnGameInput.h 程式庫: xgameruntime.lib 支援的平台: XBOX One 系列主機和 XBOX Series 主機另請參閱
將 XInput 移植到 GameInputXInputOnGameInput
XInputGetState
XInputSetState
