跳轉到主要內容

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 移植到 GameInput
XInputOnGameInput
XInputGetState
XInputSetState
最後修改於 2026年10月6日