XInputEnable 函式 (xinput.h)
設定 XInput 的報告狀態。
語法
void XInputEnable(
[in] BOOL enable
);
參數
[in] enable
如果 enable FALSE,XInput 只會傳送中性數據以回應 XInputGetState(所有向上按鈕、軸置中,以及 0 的觸發程式)。 XInputSetState 呼叫將會註冊,但不會傳送至裝置。 傳送非 FALSE 以外的任何值,會將讀取和寫入功能還原為正常。
傳回值
沒有
言論
當應用程式取得或失去焦點時,會呼叫此函式(例如透過 WM_ACTIVATEAPP)。 使用此函式時,您不需要變更應用程式中的 XInput 查詢循環,因為如果 XInput 已停用,則一律會報告中性數據。
在支援震動效果的控制器中:
- 傳遞 FALSE 會停止目前正在播放的任何震動效果。 在此狀態下,將會註冊對 XInputSetState 的呼叫,但不會傳遞至裝置。
- 傳遞 TRUE 會將最後一個振動要求(即使為 0)傳送至 XInputSetState 裝置。
Windows 10 或更新版本:已被取代,因為系統會自動根據應用程式視窗焦點啟用/停用遊戲控制器輸入。
平臺需求
Windows 8 (XInput 1.4), DirectX SDK (XInput 1.3)要求
要求 | 價值 |
---|---|
目標平臺 | 窗戶 |
標頭 | xinput.h |
連結庫 | Xinput.lib |
DLL | Xinput1_4.dll |