IDirectInputEffect Interface

Applications use the methods of the IDirectInputEffect interface to manage effects of force-feedback devices.

IDirectInputEffect Members

Download	Places the effect on the device. If the effect is already on the device, the existing effect is updated to match the values set by the IDirectInputEffect::SetParameters method.
Escape	Sends a hardware-specific command to the driver.
GetEffectGuid	Retrieves the globally unique identifier (GUID) for the effect represented by the IDirectInputEffect object.
GetEffectStatus	Retrieves the status of an effect.
GetParameters	Retrieves information about an effect.
Initialize	Initializes a DirectInputEffect object.
SetParameters	Sets the characteristics of an effect.
Start	Begins playing an effect. If the effect is already playing, it is restarted from the beginning. If the effect has not been downloaded or has been modified since its last download, it is downloaded before being started. This default behavior can be suppressed by passing the DIES_NODOWNLOAD flag.
Stop	Stops playing an effect.
Unload	Removes the effect from the device. If the effect is playing, it is automatically stopped before it is unloaded.

Remarks

The interface is obtained by using the IDirectInputDevice8::CreateEffect method.

The LPDIRECTINPUTEFFECT type is defined as a pointer to the IDirectInputEffect interface:

typedef struct IDirectInputEffect    *LPDIRECTINPUTEFFECT;

Interface Information

Inherits from	IUnknown
Header	dinput.h
Minimum operating systems	Windows 98