Platform SDK: DirectX |
IDirectInputDevice7::CreateEffect メソッドは、エフェクトの GUID によって識別されるエフェクトのインスタンスを作成、初期化する。
HRESULT CreateEffect( REFGUID rguid, LPCDIEFFECT lpeff, LPDIRECTINPUTEFFECT * ppdeff, LPUNKNOWN punkOuter );
以下のエフェクト GUID が定義されている。
成功すれば DI_OK を返す。
失敗すれば次のエラー値のいずれかを返す。
DIERR_DEVICENOTREG |
DIERR_DEVICEFULL |
DIERR_INVALIDPARAM |
DIERR_NOTINITIALIZED |
戻り値が S_OK である場合、エフェクトは作成済みで、エフェクトのパラメータは更新済みであるが、エフェクトをダウンロードする必要がなかったことを示す。エフェクトをダウンロードするには、デバイスを排他モードで取得しなければならない。
Windows NT/2000 :Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dinput.h で宣言。
インポート ライブラリ : dinput.lib を使用。