次の方法で共有

IDirectInputEffect::Start

  • [アーティクル]

エフェクトの再生を開始します。エフェクトが既に再生中の場合は、最初から再開されます。エフェクトがダウンロードされていない場合、または最後のダウンロード以降に変更された場合は、開始される前にダウンロードされます。この既定の動作は、DIES_NODOWNLOAD フラグを渡すことによって抑止できます。

HRESULT 
Start(
  DWORD dwIterations,
  DWORD dwFlags
);

パラメータ

  • dwIterations
    エフェクトを連続して再生する回数。エンベロープは繰り返しのたびに再び表現されます。エフェクトを 1 回限り再生するには、1 を渡します。明示的に停止されるまでエフェクトを繰り返し再生するには、INFINITE を渡します。エンベロープを再び表現せずに、明示的に停止されるまでエフェクトを再生するには、IDirectInputEffect::SetParameters メソッドを使用してエフェクト パラメーターを変更し、dwDuration メンバーを INFINITE に変更します。
  • dwFlags
    デバイスがエフェクトを再生する方法を示すフラグ。値は 0、または次のいずれかの値 (複数可) を指定します。
    • DIES_SOLO
      指定したエフェクトを再生する前に、デバイス上の他のエフェクトをすべて停止します。このフラグを省略すると、エフェクトはデバイス上で既に開始されている既存のエフェクトと混合されます。
    • DIES_NODOWNLOAD
      エフェクトを自動的にダウンロードしません。

戻り値

メソッドが正常に実行された場合、戻り値は DI_OK です。メソッドが失敗した場合、戻り値は次のいずれかのエラー値です。DIERR_INCOMPLETEEFFECT、DIERR_INVALIDPARAM、DIERR_NOTEXCLUSIVEACQUIRED、DIERR_NOTINITIALIZED、DIERR_UNSUPPORTED

解説　

このメソッドを正常に実行するには、デバイスを排他協調レベルで獲得する必要があります。

デバイスによっては複数回の繰り返しはサポートされません。

要件

ヘッダー: Dinput.h 宣言