次の方法で共有

XInputEnable

  • [アーティクル]

XInput の報告の状態を設定します。

構文

void XInputEnable(  
         BOOL enable  
)

パラメーター

enable _In_
型: BOOL

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

戻り値

型: void

ありません。

解説

この関数は非推奨になったため、新しいコードでは記述しないでください。 XInputEnable は、多くの XInput ラッパー呼び出しにオーバーヘッドを加えます。 #define XINPUT_ON_GAMEINPUT_NO_XINPUTENABLE を使用すると、XInputEnable を使わずにすみ、それによるオーバーヘッドをなくすことができます。 詳細については、「XInput から GameInput への移植」を参照してください。

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

振動効果をサポートするコントローラーの場合:

  • FALSE を渡すと、その時点で再生中の振動効果がすべて停止します。 この状態では、XInputSetState への呼び出しは登録されますが、デバイスには渡されません。
  • TRUE を渡すと、XInputSetState およびデバイスに送信された最後の振動要求 (0 の場合も含む) が渡されます。

要件

ヘッダー: XInputOnGameInput.h

ライブラリ: xgameruntime.lib

サポートされているプラットフォーム: Xbox One ファミリー本体、Xbox Series 本体

関連項目

XInput から GameInput への移植
XInputOnGameInput
XInputGetState
XInputSetState