XInputEnable
XInput のレポート ステートを設定します。
構文
void XInputEnable( BOOL enable)
パラメーター
- enable
enable が FALSE の場合、XInput は XInputGetState に対してニュートラル データ (押下されたボタンなし、軸を中央に配置、トリガーは 0) を送信します。XInputSetState 呼び出しは登録されますが、デバイスには送信されません。FALSE 以外の任意の値を送信すると、読み込み/書き込み機能は標準に戻ります。
戻り値
なし。
解説
この関数は、アプリケーションが (WM_ACTIVATEAPP などを通じて) フォーカスを取得したり失ったりときに呼び出されます。この関数を使用すると、アプリケーションで XInput クエリ ループを変更する必要がありません。XInput が無効になった場合にニュートラル データが常にレポートされるためです。
バイブレーション エフェクトをサポートしているコントローラーでは、次のように処理されます。
FALSE を渡すと、再生中のバイブレーション エフェクトがすべて停止します。この状態では、XInputSetState の呼び出しは登録されますが、デバイスに渡されません。
TRUE を渡すと、XInputSetState に最後に送信されたバイブレーション要求が (0 の場合でも) デバイスに渡されます。
要件
ヘッダー: XInput.h で宣言されています。
ライブラリ: xinput.lib を使用します。
関連項目
XInput 関数
XInputGetState
XInputSetState
XINPUT_STATE
XINPUT_GAMEPAD