?/TD>
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

ConfigureDevices

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

CreateDevice

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

EnumDevices

Enumerates available devices.

EnumDevicesBySemantics

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

FindDevice

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.

GetDeviceStatus

Retrieves the status of a specified device.

Initialize

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

RunControlPanel

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

Remarks

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
Headerdinput.h
Minimum operating systems Windows 98


© 2002 Microsoft Corporation. All rights reserved.