Platform SDK: DirectX

DirectInputEffect.Download

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 のリファレンスの中で説明されている。