Microsoft DirectX 8.0 (C++) |
デバイスにエフェクトを設定する。同じエフェクトが既にデバイスにあれば、IDirectInputEffect::SetParameters メソッドで設定された値に適合するように、既存のエフェクトが更新される。
HRESULT Download(void);
なし。
成功した場合は、DI_OK を返す。
失敗した場合は、次のいずれかのエラー値を返す。
DIERR_DEVICEFULL |
DIERR_EFFECTPLAYING |
DIERR_INCOMPLETEEFFECT |
DIERR_INPUTLOST |
DIERR_INVALIDPARAM |
DIERR_NOTEXCLUSIVEACQUIRED |
DIERR_NOTINITIALIZED |
S_FALSE が返された場合、そのエフェクトは既にデバイスにダウンロードされている。
エフェクトの再生中にエフェクトを更新することは有効である。この操作の意味は、IDirectInputEffect::SetParameters のリファレンスの中で説明されている。
Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
ヘッダー : dinput.h で宣言。