Platform SDK: DirectX |
IDirectInputEffect::Start メソッドは、エフェクトの再生を開始する。エフェクトが既に再生中ならば、最初から開始される。エフェクトがダウンロードされていないか、または前回のダウンロード以来、変更されている場合は、開始前にエフェクトがダウンロードされる。この処理はデフォルトで行われる。これを抑制するには、DIES_NODOWNLOAD フラグを渡せばよい。
HRESULT Start( DWORD dwIterations, DWORD dwFlags );
エフェクトを一度だけ再生するには、1 を渡す。明示的に停止させられるまで反復再生するには、INFINITE を渡す。エンベロープを再調整しないで、明示的に停止させられるまでエフェクトを再生するには、IDirectInputEffect::SetParameters メソッドを使用してエフェクト パラメータを修正した後、その dwDuration メンバを INFINITE に変更する。
成功すれば DI_OK を返す。
失敗すれば次のエラー値のいずれかを返す。
DIERR_INVALIDPARAM |
DIERR_INCOMPLETEEFFECT |
DIERR_NOTEXCLUSIVEACQUIRED |
DIERR_NOTINITIALIZED |
DIERR_UNSUPPORTED |
このメソッドを成功させるには、デバイスを排他協調レベルで取得しなければならない。
複数回の繰り返しをサポートしないデバイスもある。
Windows NT/2000 :Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dinput.h で宣言。
インポート ライブラリ : dinput.lib を使用。