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