Skip to main content

XInputSetStateEx

指定したコントローラーにバイブレーション データを送信します。新しいコントローラーの 4 モーター バイブレーション機能をサポートします。

構文

パラメーター

dwUserIndex   _In_
型: DWORD
デバイスに関連付けられているゲーマーのインデックス。0 ~ XUSER_MAX_COUNT - 1 の範囲の値。 pVibration   _In_
型: XINPUT_VIBRATION_EX*
コントローラーに送信するバイブレーション情報を含む XINPUT_VIBRATION_EX オブジェクトへのポインター。

戻り値

型: DWORD 関数が成功した場合は ERROR_SUCCESS を返します。 コントローラーが接続されていない場合、関数は ERROR_DEVICE_NOT_CONNECTED を返します。 関数が失敗した場合は、WinError.h で定義されているエラー コードを返します。

解説

この関数は、2 モーター コントローラーとの操作中でも安全に呼び出すことができます。2 モーター コントローラー向けに XInputSetStateEx に送信されたバイブレーション設定は、送信された入力に対して最良の近似値でコントローラーが振動するように調整されます。このため、XInputSetState を呼び出すような場面では XInputSetStateEx を呼び出すことをお勧めします。 詳細については、XInputOnGameInput ラッパーを参照してください。

要件

ヘッダー: XInputOnGameInput.h ライブラリ: xgameruntime.lib 対応プラットフォーム: XBOX One ファミリー本体および XBOX Series 本体

関連項目

XInput から GameInput への移植
XInputOnGameInput
最終更新日 2026年8月24日