XInputEnable 関数 (xinput.h)

[アーティクル]
03/13/2024

XInput のレポートの状態を設定します。

構文

void XInputEnable(
  [in] BOOL enable
);

パラメーター

[in] enable

enable が FALSE の場合、XInput は、XInputGetState (すべてのボタンの上、軸の中央揃え、0 のトリガー) に応答してニュートラルデータのみを送信します。 XInputSetState 呼び出しは登録されますが、デバイスには送信されません。 FALSE 以外の値を送信すると、読み取りと書き込みの機能が正常に復元されます。

戻り値

なし

解説

この関数は、アプリケーションがフォーカスを取得または失ったときに呼び出されることを意図 WM_ACTIVATEAPP。この関数を使用すると、XInput が無効になっている場合にニュートラルデータが常に報告されるため、アプリケーションで XInput クエリループを変更する必要はありません。

振動効果をサポートするコントローラーでは、次の手順を実行します。

FALSE を渡すと、現在再生されている振動効果が停止します。この状態では、 XInputSetState の呼び出しは登録されますが、デバイスには渡されません。
TRUE を渡すと、XInputSetState に送信された最後の振動要求 (0 の場合でも) がデバイスに渡されます。

Windows 10以降:ゲームコントローラーの入力は、アプリケーションウィンドウのフォーカスに基づいてシステムによって自動的に有効または無効にされるため、非推奨です。