Microsoft DirectX 9.0

IDirectInput8 Interface

Applications use the methods of the IDirectInput8 interface to enumerate, create, and retrieve the status of Microsoft?DirectInput?devices, initialize the DirectInput object, and invoke an instance of the Microsoft Windows?Control Panel.

IDirectInput8 Members


Displays property pages for connected input devices and enables the user to map actions to device controls.


Creates and initializes an instance of a device based on a given globally unique identifier (GUID), and obtains an IDirectInputDevice8 interface.


Enumerates available devices.


Enumerates devices that most closely match the application-specified action map.


Retrieves the instance GUID of a device that has been newly attached to the system. It is called in response to a Microsoft Win32? device management notification.


Retrieves the status of a specified device.


Initializes a DirectInput object. Applications normally do not need to call this method. The DirectInput8Create function automatically initializes the DirectInput object after creating it.


Runs Control Panel to enable the user to install a new input device or modify configurations.


IDirectInput8 supersedes the IDirectInput, IDirectInput2, and IDirectInput7 interfaces used in earlier versions of Microsoft DirectX?

IDirectInput8 is an interface to a new class of object, represented by the class identifier CLSID_DirectInput8, and cannot be obtained by calling QueryInterface on an interface to objects of class CLSID_DirectInput. Instead, obtain the IDirectInput8 interface by using the DirectInput8Create function.

The LPDIRECTINPUT8 type is defined as a pointer to the IDirectInput8 interface:

typedef struct IDirectInput8    *LPDIRECTINPUT8;

Interface Information

Inherits fromIUnknown
Minimum operating systems Windows 98

© 2002 Microsoft Corporation. All rights reserved.