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;