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