IDirectInputEffect::Download

デバイスにエフェクトを配置します。エフェクトが既にデバイス上に存在する場合は、IDirectInputEffect::SetParameters メソッドによって設定された値と一致するように、既存のエフェクトが更新されます。

HRESULT 
Download(
);

パラメータ

なし。

戻り値

メソッドが正常に実行された場合、戻り値は DI_OK または S_FALSE です。メソッドが失敗した場合、戻り値は次のいずれかのエラー値です。DIERR_DEVICEFULL、DIERR_EFFECTPLAYING、DIERR_INCOMPLETEEFFECT、DIERR_INPUTLOST、DIERR_INVALIDPARAM、DIERR_NOTEXCLUSIVEACQUIRED、DIERR_NOTINITIALIZED

解説　

このメソッドが S_FALSE を返す場合、エフェクトはデバイスに既にダウンロード済みです。

再生中のエフェクトの更新は有効です。このような更新によって生じる動作については、IDirectInputEffect::SetParameters のリファレンスで説明しています。

要件

ヘッダー: Dinput.h 宣言