DIDEVICEINSTANCE

Describes an instance of a Microsoft® DirectInput® device. This structure is used with the IDirectInput8::EnumDevices, IDirectInput8::EnumDevicesBySemantics, and IDirectInputDevice8::GetDeviceInfo methods.

typedef struct DIDEVICEINSTANCE { 
    DWORD dwSize; 
    GUID  guidInstance; 
    GUID  guidProduct; 
    DWORD dwDevType; 
    TCHAR tszInstanceName[MAX_PATH]; 
    TCHAR tszProductName[MAX_PATH];
    GUID  guidFFDriver;
    WORD  wUsagePage; 
    WORD  wUsage;
} DIDEVICEINSTANCE, *LPDIDEVICEINSTANCE; 
 
typedef const DIDEVICEINSTANCE  *LPCDIDEVICEINSTANCE;

Members

dwSize

Size of this structure, in bytes. This member must be initialized before the structure is used.

guidInstance

Unique identifier for the instance of the device. An application can save the instance GUID into a configuration file and use it at a later time. Instance GUIDs are specific to a particular computer. An instance GUID obtained from one computer is unrelated to instance GUIDs on another.

guidProduct

Unique identifier for the product. This identifier is established by the manufacturer of the device.

dwDevType

Device type specifier. The least-significant byte of the device type description code specifies the device type. The next-significant byte specifies the device subtype. This value can also be combined with DIDEVTYPE_HID, which specifies a Human Interface Device (HID).

tszInstanceName[MAX_PATH]

Friendly name for the instance. For example, "Joystick 1."

tszProductName[MAX_PATH]

Friendly name for the product.

guidFFDriver

Unique identifier for the driver being used for force feedback. The driver's manufacturer establishes this identifier.

wUsagePage

If the device is a Human Interface Device (HID), this member contains the HID usage page code.

wUsage

If the device is a Human Interface Device (HID), this member contains the HID usage code.

Remarks

The following device types and subtypes are defined for use in the dwDevType member.

DI8DEVTYPE_1STPERSON

First-person action game device. The following subtypes are defined.

DI8DEVTYPE1STPERSON_LIMITED

Device that does not provide the minimum number of device objects for action mapping.

DI8DEVTYPE1STPERSON_SHOOTER

Device designed for first-person shooter games.

DI8DEVTYPE1STPERSON_SIXDOF

Device with six degrees of freedom; that is, three lateral axes and three rotational axes.

DI8DEVTYPE1STPERSON_UNKNOWN

Unknown subtype.

DI8DEVTYPE_DEVICE

Device that does not fall into another category.

DI8DEVTYPE_DEVICECTRL

Input device used to control another type of device from within the context of the application. The following subtypes are defined.

DI8DEVTYPEDEVICECTRL_COMMSSELECTION

Control used to make communications selections.

DI8DEVTYPEDEVICECTRL_COMMSSELECTION_HARDWIRED

Device that must use its default configuration and cannot be remapped.

DI8DEVTYPEDEVICECTRL_UNKNOWN

Unknown subtype.

DI8DEVTYPE_DRIVING

Device for steering. The following subtypes are defined.

DI8DEVTYPEDRIVING_COMBINEDPEDALS

Steering device that reports acceleration and brake pedal values from a single axis.

DI8DEVTYPEDRIVING_DUALPEDALS

Steering device that reports acceleration and brake pedal values from separate axes.

DI8DEVTYPEDRIVING_HANDHELD

Hand-held steering device.

DI8DEVTYPEDRIVING_LIMITED

Steering device that does not provide the minimum number of device objects for action mapping.

DI8DEVTYPEDRIVING_THREEPEDALS

Steering device that reports acceleration, brake, and clutch pedal values from separate axes.

DI8DEVTYPE_FLIGHT

Controller for flight simulation. The following subtypes are defined.

DI8DEVTYPEFLIGHT_LIMITED

Flight controller that does not provide the minimum number of device objects for action mapping.

DI8DEVTYPEFLIGHT_RC

Flight device based on a remote control for model aircraft.

DI8DEVTYPEFLIGHT_STICK

Joystick.

DI8DEVTYPEFLIGHT_YOKE

Yoke.

DI8DEVTYPE_GAMEPAD

Gamepad. The following subtypes are defined.

DI8DEVTYPEGAMEPAD_LIMITED

Gamepad that does not provide the minimum number of device objects for action mapping.

DI8DEVTYPEGAMEPAD_STANDARD

Standard gamepad that provides the minimum number of device objects for action mapping.

DI8DEVTYPEGAMEPAD_TILT

Gamepad that can report x-axis and y-axis data based on the attitude of the controller.

DI8DEVTYPE_JOYSTICK

Joystick. The following subtypes are defined.

DI8DEVTYPEJOYSTICK_LIMITED

Joystick that does not provide the minimum number of device objects for action mapping.

DI8DEVTYPEJOYSTICK_STANDARD

Standard joystick that provides the minimum number of device objects for action mapping.

DI8DEVTYPE_KEYBOARD

Keyboard or keyboard-like device. The following subtypes are defined.

DI8DEVTYPEKEYBOARD_UNKNOWN

Subtype could not be determined.

DI8DEVTYPEKEYBOARD_PCXT

IBM PC/XT 83-key keyboard.

DI8DEVTYPEKEYBOARD_OLIVETTI

Olivetti 102-key keyboard.

DI8DEVTYPEKEYBOARD_PCAT

IBM PC/AT 84-key keyboard.

DI8DEVTYPEKEYBOARD_PCENH

IBM PC Enhanced 101/102-key or Microsoft Natural® keyboard.

DI8DEVTYPEKEYBOARD_NOKIA1050

Nokia 1050 keyboard.

DI8DEVTYPEKEYBOARD_NOKIA9140

Nokia 9140 keyboard.

DI8DEVTYPEKEYBOARD_NEC98

Japanese NEC PC98 keyboard.

DI8DEVTYPEKEYBOARD_NEC98LAPTOP

Japanese NEC PC98 laptop keyboard.

DI8DEVTYPEKEYBOARD_NEC98106

Japanese NEC PC98 106-key keyboard.

DI8DEVTYPEKEYBOARD_JAPAN106

Japanese 106-key keyboard.

DI8DEVTYPEKEYBOARD_JAPANAX

Japanese AX keyboard.

DI8DEVTYPEKEYBOARD_J3100

Japanese J3100 keyboard.

DI8DEVTYPE_MOUSE

A mouse or mouse-like device (such as a trackball). The following subtypes are defined.

DI8DEVTYPEMOUSE_ABSOLUTE

Mouse that returns absolute axis data.

DI8DEVTYPEMOUSE_FINGERSTICK

Fingerstick.

DI8DEVTYPEMOUSE_TOUCHPAD

Touchpad.

DI8DEVTYPEMOUSE_TRACKBALL

Trackball.

DI8DEVTYPEMOUSE_TRADITIONAL

Traditional mouse.

DI8DEVTYPEMOUSE_UNKNOWN

Subtype could not be determined.

DI8DEVTYPE_REMOTE

Remote-control device. The following subtype is defined.

DI8DEVTYPEREMOTE_UNKNOWN

Subtype could not be determined.

DI8DEVTYPE_SCREENPOINTER

Screen pointer. The following subtypes are defined.

DI8DEVTYPESCREENPTR_UNKNOWN

Unknown subtype.

DI8DEVTYPESCREENPTR_LIGHTGUN

Light gun.

DI8DEVTYPESCREENPTR_LIGHTPEN

Light pen.

DI8DEVTYPESCREENPTR_TOUCH

Touch screen.

DI8DEVTYPE_SUPPLEMENTAL

Specialized device with functionality unsuitable for the main control of an application, such as pedals used with a wheel. The following subtypes are defined.

DI8DEVTYPESUPPLEMENTAL_2NDHANDCONTROLLER

Secondary handheld controller.

DI8DEVTYPESUPPLEMENTAL_COMBINEDPEDALS

Device whose primary function is to report acceleration and brake pedal values from a single axis.

DI8DEVTYPESUPPLEMENTAL_DUALPEDALS

Device whose primary function is to report acceleration and brake pedal values from separate axes.

DI8DEVTYPESUPPLEMENTAL_HANDTRACKER

Device that tracks hand movement.

DI8DEVTYPESUPPLEMENTAL_HEADTRACKER

Device that tracks head movement.

DI8DEVTYPESUPPLEMENTAL_RUDDERPEDALS

Device with rudder pedals.

DI8DEVTYPESUPPLEMENTAL_SHIFTER

Device that reports gear selection from an axis.

DI8DEVTYPESUPPLEMENTAL_SHIFTSTICKGATE

Device that reports gear selection from button states.

DI8DEVTYPESUPPLEMENTAL_SPLITTHROTTLE

Device whose primary function is to report at least two throttle values. It may have other controls.

DI8DEVTYPESUPPLEMENTAL_THREEPEDALS

Device whose primary function is to report acceleration, brake, and clutch pedal values from separate axes.

DI8DEVTYPESUPPLEMENTAL_THROTTLE

Device whose primary function is to report a single throttle value. It may have other controls.

DI8DEVTYPESUPPLEMENTAL_UNKNOWN

Unknown subtype.

Versions of DirectInput earlier than Microsoft DirectX® 8.0 have a somewhat different scheme of device types and subtypes. See the DIDEVTYPExxx defines in Dinput.h.

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.