次の方法で共有


XInputEnable

XInput のレポート ステートを設定します。

構文

void XInputEnable(         BOOL enable)

パラメーター

  • enable
    enableFALSE の場合、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