| Microsoft DirectX 8.1 (C++) |
IDirectInputDevice8
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.
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 methods of the IDirectInputDevice8 interface can be organized into the following groups.
| Accessing input devices | Acquire |
| Unacquire | |
| Action mapping | BuildActionMap |
| GetImageInfo | |
| SetActionMap | |
| Device information | GetCapabilities |
| GetDeviceData | |
| GetDeviceInfo | |
| GetDeviceState | |
| Poll | |
| SetDataFormat | |
| SetEventNotification | |
| Device objects | EnumObjects |
| GetObjectInfo | |
| Device properties | GetProperty |
| SetCooperativeLevel | |
| SetProperty | |
| Force feedback | CreateEffect |
| EnumCreatedEffectObjects | |
| EnumEffects | |
| EnumEffectsInFile | |
| Escape | |
| GetEffectInfo | |
| GetForceFeedbackState | |
| SendForceFeedbackCommand | |
| WriteEffectToFile | |
| Miscellaneous | Initialize |
| RunControlPanel | |
| SendDeviceData |
The IDirectInputDevice8 interface, like all COM interfaces, inherits the IUnknown interface methods. The IUnknown interface supports the following three methods:
| IUnknown | AddRef |
| QueryInterface | |
| Release |
The LPDIRECTINPUTDEVICE8 type is defined as a pointer to the IDirectInputDevice8 interface:
typedef struct IDirectInputDevice8 *LPDIRECTINPUTDEVICE8;
Requirements
Windows NT/2000/XP: Requires Windows® 2000.
Windows 98/Me: Requires Windows 98 or later. Available as a redistributable for Windows 98.
Header: Declared in Dinput.h.