IDirectInputDevice8

DirectX8

IDirectInputDevice8
 
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.

See Also

IDirectInputDevice8