Human Interface Devices Reference
Overview of the Human Interface Devices (HID) technology reference.
To develop Human Interface Devices, you need these headers:
For HID drivers programming guidance, see:
IOCTLs
| IOCTL_KEYBOARD_QUERY_ATTRIBUTES The IOCTL_KEYBOARD_QUERY_ATTRIBUTES request returns information about the keyboard attributes. |
| IOCTL_KEYBOARD_QUERY_EXTENDED_ATTRIBUTES The IOCTL_KEYBOARD_QUERY_EXTENDED_ATTRIBUTES request returns information about the extended keyboard attributes. |
| IOCTL_KEYBOARD_QUERY_INDICATOR_TRANSLATION The IOCTL_KEYBOARD_QUERY_INDICATOR_TRANSLATION request returns information about the mapping between scan codes and keyboard indicators. |
| IOCTL_KEYBOARD_QUERY_INDICATORS The IOCTL_KEYBOARD_QUERY_INDICATORS request returns information about the keyboard indicators. |
| IOCTL_KEYBOARD_QUERY_TYPEMATIC The IOCTL_KEYBOARD_QUERY_TYPEMATIC request returns the keyboard typematic settings. |
| IOCTL_KEYBOARD_SET_INDICATORS The IOCTL_KEYBOARD_SET_INDICATORS request sets the keyboard indicators. |
| IOCTL_KEYBOARD_SET_TYPEMATIC The IOCTL_KEYBOARD_SET_TYPEMATIC request sets the keyboard typematic settings. |
| IOCTL_MOUSE_QUERY_ATTRIBUTES The IOCTL_MOUSE_QUERY_ATTRIBUTES request returns information about the mouse attributes. |
Functions
| Acquire The IDirectInputJoyConfig8::Acquire method acquires "joystick configuration mode." Only one application can be in joystick configuration mode at a time; subsequent attempts by other applications to acquire this mode should receive the error DIERR_OTHERAPPHASPRIO. After entering configuration mode, the application can make alterations to the global joystick configuration settings. The application should check the existing settings before installing the new ones in case another application changed the settings in the interim. |
| AddNewHardware The IDirectInputJoyConfig8::AddNewHardware method displays the Add New Hardware dialog box which guides the user through installing a new input device. |
| AddRef The IDirectInputEffectDriver::AddRef method increases the reference count of the DirectInputEffectDriver object by 1. This method is part of the IUnknown interface inherited by DirectInputEffectDriver. |
| AddRef The IDirectInputJoyConfig8::AddRef method increases the reference count of the DirectInputJoyConfig object by 1. This method is part of the IUnknown interface inherited by DirectInputJoyConfig. |
| DeleteConfig The IDirectInputJoyConfig8::DeleteConfig method deletes configuration information about a joystick. |
| DeleteType The IDirectInputJoyConfig8::DeleteType method removes information about a joystick type. Use this method with caution; it is the caller's responsibility to ensure that no joystick refers to the deleted type. |
| DestroyEffect The IDirectInputEffectDriver::DestroyEffect method removes an effect from the device. If the effect is playing, the driver should stop it before unloading it. |
| DeviceID The IDirectInputEffectDriver::DeviceID method sends the driver the identity of the device. |
| DownloadEffect The IDirectInputEffectDriver::DownloadEffect method sends an effect to the device. |
| EnumTypes The IDirectInputJoyConfig8::EnumTypes method enumerates the joystick types currently supported by DirectInput. |
| Escape The IDirectInputEffectDriver::Escape method escapes to the driver. This method is called in response to an application invoking the IDirectInputEffect::Escape or IDirectInputDevice::Escape methods. |
| GetConfig The IDirectInputJoyConfig8::GetConfig method obtains information about a joystick's configuration. |
| GetEffectStatus The IDirectInputEffectDriver::GetEffectStatus method obtains information about the status of an effect. |
| GetForceFeedbackState The IDirectInputEffectDriver::GetForceFeedbackState method retrieves the force-feedback state for the device. |
| GetTypeInfo The IDirectInputJoyConfig8::GetTypeInfo method obtains information about a joystick type. |
| GetUserValues The IDirectInputJoyConfig8::GetUserValues method obtains information about user settings for the joystick. |
| GetVersions The IDirectInputEffectDriver::GetVersions method obtains version information about the force-feedback hardware and driver. |
| OpenAppStatusKey The IDirectInputJoyConfig8::OpenAppStatusKey method opens the root key of the application status registry keys, and obtains a handle to the key as a return parameter. |
| OpenTypeKey The IDirectInputJoyConfig8::OpenTypeKey method opens the registry key associated with a joystick type. |
| QueryInterface The IDirectInputEffectDriver::QueryInterface method determines whether the DirectInputEffectDriver object supports a particular COM interface. |
| QueryInterface The IDirectInputJoyConfig8::QueryInterface method determines whether the DirectInputJoyConfig object supports a particular COM interface. |
| Release The IDirectInputEffectDriver::Release method decreases the reference count of the DirectInputEffectDriver object by 1. This method is part of the IUnknown interface inherited by DirectInputEffectDriver. |
| Release The IDirectInputJoyConfig8::Release method decreases the reference count of the DirectInputJoyConfig object by 1. This method is part of the IUnknown interface inherited by DirectInputJoyConfig. |
| SendForceFeedbackCommand The IDirectInputEffectDriver::SendForceFeedbackCommand method changes the force-feedback state for the device. |
| SendNotify The IDirectInputJoyConfig8::SendNotify method notifies device drivers and applications that changes to the device configuration have been made. |
| SetConfig The IDirectInputJoyConfig8::SetConfig method creates or redefines configuration information about a joystick. |
| SetCooperativeLevel The IDirectInputJoyConfig8::SetCooperativeLevel method establishes the cooperation level for the instance of the device. The only cooperative levels supported for the IDirectInputJoyConfig8 interface are DISCL_EXCLUSIVE and DISCL_BACKGROUND. |
| SetGain The IDirectInputEffectDriver::SetGain method sets the overall device gain. |
| SetTypeInfo The IDirectInputJoyConfig8::SetTypeInfo method creates a new joystick type or redefines information about an existing joystick type. |
| SetUserValues The IDirectInputJoyConfig8::SetUserValues method sets the user settings for the joystick. |
| StartEffect The IDirectInputEffectDriver::StartEffect method begins the playback of an effect. If the effect is already playing, it is restarted from the beginning. |
| StopEffect The IDirectInputEffectDriver::StopEffect method halts the playback of an effect. |
| Unacquire The IDirectInputJoyConfig8::Unacquire method unacquires "joystick configuration mode". |
Interfaces
| IDirectInputEffectDriver These three methods allow additional interfaces to be added to the DirectInputEffectDriver object without affecting the functionality of the original interface. |
| IDirectInputJoyConfig8 IDirectInputJoyConfig8 interface contains methods that allow hardware developers who are writing property sheets to write and read information to and from the registry. |
Structures
| DIDEVICESTATE The DIDEVICESTATE structure returns information about the state of a force feedback device. |
| DIDRIVERVERSIONS The DIDRIVERVERSIONS structure is used by the DirectInput effect driver to report version information back to DirectInput. |
| DIEFFECTATTRIBUTES The DIEFFECTATTRIBUTES structure describes the information contained in the "Attributes" value of the registry key for each effect that is supported by a force-feedback device. |
| DIEFFESCAPE The DIEFFESCAPE structure passes hardware-specific data directly to the device driver. |
| DIFFDEVICEATTRIBUTES The DIFFDEVICEATTRIBUTES structure describes the information contained in the "Attributes" value of the OEMForceFeedback registry key. |
| DIFFOBJECTATTRIBUTES The DIFFOBJECTATTRIBUTES structure describes the information contained in the "FFAttributes" value of the registry key for each "object" on a force-feedback device. |
| DIHIDFFINITINFO The DIHIDFFINITINFO structure is used by DirectInput to provide information to a HID force-feedback driver about the device it is being asked to control. |
| DIJOYCONFIG The DIJOYCONFIG structure contains information about a joystick's configuration. |
| DIJOYTYPEINFO The DIJOYTYPEINFO structure contains information about a joystick type. |
| DIJOYUSERVALUES The DIJOYUSERVALUES structure contains information about the user's joystick settings. |
| DIOBJECTATTRIBUTES The DIOBJECTATTRIBUTES structure describes the information contained in the "Attributes" value of the registry key for each "object" on a device. If the "Attributes" value is absent, then default attributes are used. |
| DIOBJECTCALIBRATION The DIOBJECTCALIBRATION structure describes the information contained in the "Calibration" value of the registry key for each axis on a device. |
| JOYREGHWVALUES The JOYREGHWVALUES (mmddk.h) structure contains the range of values returned by the hardware (filled in by calibration). |
| JOYREGHWVALUES The JOYREGHWVALUES (dinputd.h) structure contains the range of values returned by the hardware (filled in by calibration). |
| KEYBOARD_ATTRIBUTES KEYBOARD_ATTRIBUTES specifies the attributes of a keyboard. |
| KEYBOARD_EXTENDED_ATTRIBUTES KEYBOARD_EXTENDED_ATTRIBUTES specifies the extended attributes of a keyboard. |
| KEYBOARD_INDICATOR_PARAMETERS KEYBOARD_INDICATOR_PARAMETERS specifies the state of a keyboard's indicator LEDs. |
| KEYBOARD_INDICATOR_TRANSLATION KEYBOARD_INDICATOR_TRANSLATION specifies a device-specific, variable length array of mappings between keyboard scan codes and LED indicators. |
| KEYBOARD_INPUT_DATA KEYBOARD_INPUT_DATA contains one packet of keyboard input data. |
| KEYBOARD_TYPEMATIC_PARAMETERS KEYBOARD_TYPEMATIC_PARAMETERS specifies a keyboard's typematic settings. |
| KEYBOARD_UNIT_ID_PARAMETER KEYBOARD_UNIT_ID_PARAMETER specifies the unit ID that Kbdclass assigns to a keyboard. |
| MOUSE_ATTRIBUTES MOUSE_ATTRIBUTES specifies the attributes of a mouse device. |
| MOUSE_INPUT_DATA MOUSE_INPUT_DATA contains one packet of mouse input data. |
| MOUSE_UNIT_ID_PARAMETER MOUSE_UNIT_ID_PARAMETER specifies a unit ID that Mouclass assigns to a mouse. |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for