Platform SDK: DirectX |
The IDirectInputDevice7::CreateEffect method creates and initializes an instance of an effect identified by the effect GUID.
HRESULT CreateEffect( REFGUID rguid, LPCDIEFFECT lpeff, LPDIRECTINPUTEFFECT * ppdeff, LPUNKNOWN punkOuter );
The following effect GUIDs are defined:
If the method succeeds, the return value is DI_OK.
If the method fails, the return value can be one of the following error values:
DIERR_DEVICENOTREG |
DIERR_DEVICEFULL |
DIERR_INVALIDPARAM |
DIERR_NOTINITIALIZED |
If the return value is S_OK, the effect was created, and the parameters of the effect were updated, but the effect was not necessarily downloaded. For it to be downloaded, the device must be acquired in exclusive mode.
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
Header: Declared in dinput.h.
Import Library: Use dinput.lib.