Platform SDK: DirectX

IDirectInputEffect::Download

IDirectinputEffect::Download メソッドは、デバイスにエフェクトを設定する。同じエフェクトが既にデバイスにあれば、IDirectInputEffect::SetParameters メソッドで設定された値に適合するように、既存のエフェクトが更新される。

HRESULT Download(void);

パラメータ

なし。

戻り値

成功すれば DI_OK を返す。

失敗すれば次のエラー値のいずれかを返す。

DIERR_NOTINITIALIZED
DIERR_DEVICEFULL
DIERR_INCOMPLETEEFFECT
DIERR_INPUTLOST
DIERR_NOTEXCLUSIVEACQUIRED
DIERR_INVALIDPARAM
DIERR_EFFECTPLAYING

S_FALSE が返された場合、そのエフェクトは既にデバイスにダウンロードされている。

注意

エフェクトの再生中にエフェクトを更新することは有効である。この操作の意味は、IDirectInputEffect::SetParameters のリファレンスの中で説明されている。

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dinput.h で宣言。
  インポート ライブラリ : dinput.lib を使用。