Microsoft DirectX 8.0 (Visual Basic) |
デバイスにエフェクトを設定する。そのエフェクトがデバイス上に既に存在する場合、DirectInputEffect.SetParameters メソッドで設定された値に一致するように、既存のエフェクトが更新される。
object.Download()
失敗すればエラーが発生し、Err.Number に次のいずれかのエラー コードが設定される。
DIERR_NOTINITIALIZED |
DIERR_DEVICEFULL |
DIERR_INCOMPLETEEFFECT |
DIERR_INPUTLOST |
DIERR_NOTEXCLUSIVEACQUIRED |
DIERR_INVALIDPARAM |
DIERR_EFFECTPLAYING |
このメソッドを成功させるには、デバイスを排他協調レベルで取得しなければならない。
エフェクトの再生中にエフェクトを更新することは有効である。この操作の意味については、DirectInputEffect.SetParameters の説明を参照すること。