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

  • [アーティクル]

IDirectInputEffectDriver::StartEffect メソッドは、効果の再生を開始します。 効果が既に再生されている場合は、最初から再起動されます。

構文

HRESULT StartEffect(
  DWORD unnamedParam1,
  DWORD unnamedParam2,
  DWORD unnamedParam3,
  DWORD unnamedParam4
);

パラメーター

unnamedParam1

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

unnamedParam2

再生する効果を指定します。

unnamedParam3

効果が他の効果にどのように影響するかを指定します。 以下に示すモードのみを使用できます。他のすべてのモードは予約されています。 たとえば、ドライバーは、ドライバーではなく DirectInput によって管理されるため、DIES_NODOWNLOAD フラグを受け取ることはありません。 このパラメーターには、0、1、または複数の次のフラグを指定できます。

DIES_SOLO

指定した効果を再生する前に、デバイスの他のすべての効果を停止する必要があることを示します。 このフラグを省略すると、デバイスで既に開始されている既存の効果と効果が混在します。

unnamedParam4

効果を実行する回数を指定します。 値が INFINITE の場合は、明示的に停止または一時停止するまで効果を繰り返す必要があります。

戻り値

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

要件

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