構文
パラメーター
infoArrayCount _In_型: uint32_t infoArray の要素数。すべてのフォース フィードバック モーターを取得するには、GetForceFeedbackMotorCount から返された値を渡します。 infoArray _Out_writes_to_opt_(infoArrayCount, return)
型: GameInputForceFeedbackMotorInfo* フォース フィードバック モーターごとに 1 つの構造体を受け取る配列へのポインター。
nullptr を指定できます。その場合、何も書き込まれず、メソッドは 0 を返します。
戻り値
型: uint32_t infoArray に書き込まれた要素の数。これは infoArrayCount とデバイス上のフォース フィードバック モーターの数のうち小さい方の値です。infoArray がnullptr の場合、またはデバイスにフォース フィードバック モーターがない場合は 0 です。
解説
各要素は GameInputForceFeedbackMotorInfo 構造体で、対応するモーターが駆動する軸と、そのモーターがサポートするフォース フィードバック エフェクトの種類を記述します。 GetForceFeedbackMotorCount を呼び出してフォース フィードバック モーターの数を取得し、そのサイズの配列を割り当ててから、GetForceFeedbackMotorInfo を呼び出して配列にデータを格納します。infoArrayCount がフォース フィードバック モーターの数より小さい場合は、先頭から infoArrayCount 個の要素のみが書き込まれます。デバイスが接続されている間、デバイスのフォース フィードバック モーターは変化しないため、一度クエリを実行して結果をキャッシュできます。
情報配列の要素 i は、モーター インデックスが i のモーターを記述します。このインデックスを、CreateForceFeedbackEffect、IsForceFeedbackMotorPoweredOn、SetForceFeedbackMotorGain の motorIndex パラメーターとして使用します。
次の例は、デバイスのフォース フィードバック モーターを取得する方法を示しています。
forceFeedbackMotorInfo メンバーから取得できました。
要件
ヘッダー: GameInput.h ライブラリ: gameinput.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体、XBOX Series 本体関連項目
GameInput の概要GetForceFeedbackMotorCount
GameInputForceFeedbackMotorInfo
CreateForceFeedbackEffect
IsForceFeedbackMotorPoweredOn
SetForceFeedbackMotorGain
GameInput でのフォース フィードバック
IGameInputDevice
