IDirectInputEffectDriver::SendForceFeedbackCommand メソッド (dinputd.h)

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

IDirectInputEffectDriver::SendForceFeedbackCommand メソッドは、デバイスの強制フィードバック状態を変更します。

構文

HRESULT SendForceFeedbackCommand(
  DWORD unnamedParam1,
  DWORD unnamedParam2
);

パラメーター

unnamedParam1

アドレス指定されている外部ジョイスティック番号を示します。

unnamedParam2

次のコマンドのうち、どのコマンドが送信されているかを示します。

DISFFC_RESET

アクティブな効果の再生を停止し、すべての効果をデバイスから削除する必要があることを示します。デバイスがリセットされると、すべての効果は無効になり、再作成する必要があります。

DISFFC_STOPALL

すべての効果の再生を停止する必要があることを示します。 DISFFC_STOPALL コマンドを送信することは、再生しているすべての効果に対して IDirectInputEffect::Stop メソッドを呼び出すことと同じです。デバイスが一時停止状態の場合、デバイスドライバーは一時停止状態を失うことができます。

DISFFC_PAUSE

すべての効果の再生を一時停止する必要があることを示します。効果が一時停止すると、DISFFC_CONTINUE コマンドが送信されるまで時間が "停止" されます。たとえば、5 秒の期間の効果が開始されるとします。 1 秒後、すべての効果が一時停止されます。さらに 2 秒後に、すべての効果が継続されます。その後、効果は 4 秒間再生されます。強制フィードバックデバイスの一時停止中に、新しい効果を開始したり、既存の効果を変更したりすると、一時停止状態が失われる可能性があります。

DISFFC_CONTINUE

前のDISFFC_PAUSE コマンドによって一時停止された効果に対して中断された時点で再生を再開する必要があることを示します。

DISFFC_SETACTUATORSON

デバイスのフォースフィードバックアクチュエータを有効にする必要があることを示します。

DISFFC_SETACTUATORSOFF

デバイスのフォースフィードバックアクチュエータを無効にする必要があることを示します。成功した場合、強制フィードバック効果は "ミュート" されます。アクチュエータがオフになっている間も時間が経過し続けます。たとえば、5 秒の期間の効果が開始されるとします。 1秒後にアクチュエータがオフになります。さらに 2 秒後にアクチュエータがオンになります。その後、効果は 2 秒間再生されます。

戻り値

成功した場合はS_OKを返します。それ以外の場合は、エラーコードを返します。

要件

要件	値
対象プラットフォーム	デスクトップ
Header	dinputd.h (Dinputd.h を含む)