IDirectInputDevice8 Interface

Applications use the methods of the IDirectInputDevice8 interface to gain and release access to Microsoft DirectInput devices, manage device properties and information, set behavior, perform initialization, create and play force-feedback effects, and invoke a device's control panel.

IDirectInputDevice8 Members

Method	Description
IDirectInputDevice8::Acquire	Obtains access to the input device.
IDirectInputDevice8::BuildActionMap	Builds an action map for the device and retrieves information about it.
IDirectInputDevice8::CreateEffect	Creates and initializes an instance of an effect identified by the effect globally unique identifier (GUID).
IDirectInputDevice8::EnumCreatedEffectObjects	Enumerates all the currently created effects for this device.
IDirectInputDevice8::EnumEffects	Enumerates all the effects supported by the force-feedback system on the device.
IDirectInputDevice8::EnumEffectsInFile	Enumerates all the effects in a file created by the Force Editor utility or another application using the same file format.
IDirectInputDevice8::EnumObjects	Enumerates the input and output objects available on a device.
IDirectInputDevice8::Escape	Sends a hardware-specific command to the force-feedback driver.
IDirectInputDevice8::GetCapabilities	Obtains the capabilities of the DirectInputDevice object.
IDirectInputDevice8::GetDeviceData	Retrieves buffered data from the device.
IDirectInputDevice8::GetDeviceInfo	Obtains information about the device's identity.
IDirectInputDevice8::GetDeviceState	Retrieves immediate data from the device.
IDirectInputDevice8::GetEffectInfo	Obtains information about an effect.
IDirectInputDevice8::GetForceFeedbackState	Retrieves the state of the device's force-feedback system.
IDirectInputDevice8::GetImageInfo	Retrieves information about a device image for use in a configuration property sheet.
IDirectInputDevice8::GetObjectInfo	Retrieves information about a device object, such as a button or axis.
IDirectInputDevice8::GetProperty	Retrieves information about the input device.
IDirectInputDevice8::Initialize	Initializes a DirectInputDevice object.
IDirectInputDevice8::Poll	Retrieves data from polled objects on a DirectInput device.
IDirectInputDevice8::RunControlPanel	Runs the DirectInput control panel associated with this device.
IDirectInputDevice8::SendDeviceData	Sends data to a device that accepts output.
IDirectInputDevice8::SendForceFeedbackCommand	Sends a command to the device's force-feedback system.
IDirectInputDevice8::SetActionMap	Sets the data format for a device and maps application-defined actions to device objects.
IDirectInputDevice8::SetCooperativeLevel	Establishes the cooperative level for this instance of the device.
IDirectInputDevice8::SetDataFormat	Sets the data format for the DirectInput device.
IDirectInputDevice8::SetEventNotification	Specifies an event that is to be set when the device state changes.
IDirectInputDevice8::SetProperty	Sets properties that define the device behavior.
IDirectInputDevice8::Unacquire	Releases access to the device.
IDirectInputDevice8::WriteEffectToFile	Saves information about one or more force-feedback effects to a file that can be read by using EnumEffectsInFile.

Remarks

The IDirectInputDevice8 interface is obtained by using the IDirectInput8::CreateDevice method. For an example, see Creating a DirectInput Device.

IDirectInputDevice8 supersedes the IDirectInputDevice, IDirectInputDevice2, and IDirectInputDevice7 interfaces used in previous versions of Microsoft DirectX, but does not inherit from them. Methods that share names with those from older interfaces perform similar services, but may not have exactly the same functionality or behavior. You cannot obtain the earlier interfaces by using QueryInterface.

The LPDIRECTINPUTDEVICE8 type is defined as a pointer to the IDirectInputDevice8 interface:

typedef struct IDirectInputDevice8    *LPDIRECTINPUTDEVICE8;