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 を含む) |