Microsoft DirectX 8.0 (Visual Basic)

DirectInputEffect.Download

デバイスにエフェクトを設定する。そのエフェクトがデバイス上に既に存在する場合、DirectInputEffect.SetParameters メソッドで設定された値に一致するように、既存のエフェクトが更新される。

object.Download()

指定項目

object
DirectInputEffect オブジェクトを指定する。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかのエラー コードが設定される。

DIERR_NOTINITIALIZED
DIERR_DEVICEFULL
DIERR_INCOMPLETEEFFECT
DIERR_INPUTLOST
DIERR_NOTEXCLUSIVEACQUIRED
DIERR_INVALIDPARAM
DIERR_EFFECTPLAYING

注意

このメソッドを成功させるには、デバイスを排他協調レベルで取得しなければならない。

エフェクトの再生中にエフェクトを更新することは有効である。この操作の意味については、DirectInputEffect.SetParameters の説明を参照すること。