XInputEnable
XInput のレポート状態を設定します。構文
パラメーター
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