人机接口设备参考

人机接口设备 (HID) 技术参考概述。

若要开发人机接口设备，需要以下标头：

• dinput.h
• dinputd.h
• ntddkbd.h
• ntddmou.h

有关 HID 驱动程序编程指南，请参阅：

• 人体学接口设备 (HID) 简介
• WINDOWS 驱动程序人机接口设备 (HID) API

IOCTL

IOCTL_KEYBOARD_QUERY_ATTRIBUTES IOCTL_KEYBOARD_QUERY_ATTRIBUTES请求返回有关键盘属性的信息。
IOCTL_KEYBOARD_QUERY_EXTENDED_ATTRIBUTES IOCTL_KEYBOARD_QUERY_EXTENDED_ATTRIBUTES请求返回有关扩展键盘属性的信息。
IOCTL_KEYBOARD_QUERY_INDICATOR_TRANSLATION IOCTL_KEYBOARD_QUERY_INDICATOR_TRANSLATION请求返回有关扫描代码和键盘指示器之间的映射的信息。
IOCTL_KEYBOARD_QUERY_INDICATORS IOCTL_KEYBOARD_QUERY_INDICATORS请求返回有关键盘指示器的信息。
IOCTL_KEYBOARD_QUERY_TYPEMATIC IOCTL_KEYBOARD_QUERY_TYPEMATIC请求返回键盘类型设置。
IOCTL_KEYBOARD_SET_INDICATORS IOCTL_KEYBOARD_SET_INDICATORS请求设置键盘指示器。
IOCTL_KEYBOARD_SET_TYPEMATIC IOCTL_KEYBOARD_SET_TYPEMATIC请求设置键盘类型设置。
IOCTL_MOUSE_QUERY_ATTRIBUTES IOCTL_MOUSE_QUERY_ATTRIBUTES请求返回有关鼠标属性的信息。

函数

获取 IDirectInputJoyConfig8：：Acquire 方法获取“游戏杆配置模式”。一次只能有一个应用程序处于游戏杆配置模式;其他应用程序随后尝试获取此模式时，应收到错误DIERR_OTHERAPPHASPRIO。 进入配置模式后，应用程序可以更改全局游戏杆配置设置。 应用程序应在安装新设置之前检查现有设置，以防另一个应用程序在此期间更改了设置。
AddNewHardware IDirectInputJoyConfig8：：AddNewHardware 方法显示“添加新硬件”对话框，该对话框指导用户安装新的输入设备。
AddRef IDirectInputEffectDriver：：AddRef 方法将 DirectInputEffectDriver 对象的引用计数增加 1。 此方法是 DirectInputEffectDriver 继承的 IUnknown 接口的一部分。
AddRef IDirectInputJoyConfig8：：AddRef 方法将 DirectInputJoyConfig 对象的引用计数增加 1。 此方法是 DirectInputJoyConfig 继承的 IUnknown 接口的一部分。
DeleteConfig IDirectInputJoyConfig8：:D eleteConfig 方法删除有关游戏杆的配置信息。
DeleteType IDirectInputJoyConfig8：:D eleteType 方法删除有关游戏杆类型的信息。 请谨慎使用此方法;调用方负责确保没有游戏杆引用已删除的类型。
DestroyEffect IDirectInputEffectDriver：:D estroyEffect 方法从设备中删除效果。 如果效果正在播放，驱动程序应在卸载它之前将其停止。
DeviceID IDirectInputEffectDriver：:D eviceID 方法向驱动程序发送设备的标识。
DownloadEffect IDirectInputEffectDriver：:D ownloadEffect 方法将效果发送到设备。
EnumTypes IDirectInputJoyConfig8：：EnumTypes 方法枚举 DirectInput 当前支持的游戏杆类型。
Esc 键 IDirectInputEffectDriver：：Escape 方法转义到驱动程序。 调用此方法以响应调用 IDirectInputEffect：：Escape 或 IDirectInputDevice：：Escape 方法的应用程序。
GetConfig IDirectInputJoyConfig8：：GetConfig 方法获取有关游戏杆配置的信息。
GetEffectStatus IDirectInputEffectDriver：：GetEffectStatus 方法获取有关效果状态的信息。
GetForceFeedbackState IDirectInputEffectDriver：：GetForceFeedbackState 方法检索设备的力回馈状态。
GetTypeInfo IDirectInputJoyConfig8：：GetTypeInfo 方法获取有关游戏杆类型的信息。
GetUserValues IDirectInputJoyConfig8：：GetUserValues 方法获取有关游戏杆的用户设置的信息。
GetVersions IDirectInputEffectDriver：：GetVersions 方法获取有关力回馈硬件和驱动程序的版本信息。
OpenAppStatusKey IDirectInputJoyConfig8：：OpenAppStatusKey 方法打开应用程序状态注册表项的根键，并获取密钥的句柄作为返回参数。
OpenTypeKey IDirectInputJoyConfig8：：OpenTypeKey 方法打开与游戏杆类型关联的注册表项。
QueryInterface IDirectInputEffectDriver：：QueryInterface 方法确定 DirectInputEffectDriver 对象是否支持特定的 COM 接口。
QueryInterface IDirectInputJoyConfig8：：QueryInterface 方法确定 DirectInputJoyConfig 对象是否支持特定的 COM 接口。
版本 IDirectInputEffectDriver：：Release 方法将 DirectInputEffectDriver 对象的引用计数减少 1。 此方法是 DirectInputEffectDriver 继承的 IUnknown 接口的一部分。
版本 IDirectInputJoyConfig8：：Release 方法将 DirectInputJoyConfig 对象的引用计数减少 1。 此方法是 DirectInputJoyConfig 继承的 IUnknown 接口的一部分。
SendForceFeedbackCommand IDirectInputEffectDriver：：SendForceFeedbackCommand 方法更改设备的力回馈状态。
SendNotify IDirectInputJoyConfig8：：SendNotify 方法通知设备驱动程序和应用程序已对设备配置进行了更改。
SetConfig IDirectInputJoyConfig8：：SetConfig 方法创建或重新定义有关游戏杆的配置信息。
SetCooperativeLevel IDirectInputJoyConfig8：：SetCooperativeLevel 方法为设备实例建立协作级别。 IDirectInputJoyConfig8 接口支持的唯一协作级别是DISCL_EXCLUSIVE和DISCL_BACKGROUND。
SetGain IDirectInputEffectDriver：：SetGain 方法设置设备总增益。
SetTypeInfo IDirectInputJoyConfig8：：SetTypeInfo 方法创建新的游戏杆类型或重新定义有关现有游戏杆类型的信息。
SetUserValues IDirectInputJoyConfig8：：SetUserValues 方法设置游戏杆的用户设置。
StartEffect IDirectInputEffectDriver：：StartEffect 方法开始播放效果。 如果效果已在播放，则会从头开始重启。
StopEffect IDirectInputEffectDriver：：StopEffect 方法停止播放效果。
未获取 IDirectInputJoyConfig8：：Unacquire 方法 unacquires“游戏杆配置模式”。

接口

IDirectInputEffectDriver 这三种方法允许将其他接口添加到 DirectInputEffectDriver 对象，而不会影响原始接口的功能。
IDirectInputJoyConfig8 IDirectInputJoyConfig8 接口包含的方法允许编写属性表的硬件开发人员向注册表写入和读取信息。

结构

DIDEVICESTATE DIDEVICESTATE 结构返回有关力回馈设备状态的信息。
DIDRIVERVERSIONS DIRECTInput 效果驱动程序使用 DIDRIVERVERSIONS 结构将版本信息报告回 DirectInput。
DIEFFECTATTRIBUTES DIEFFECTATTRIBUTES 结构描述由力回馈设备支持的每个效果的注册表项的“Attributes”值中包含的信息。
DIEFFESCAPE DIEFFESCAPE 结构将特定于硬件的数据直接传递给设备驱动程序。
DIFFDEVICEATTRIBUTES DIFFDEVICEATTRIBUTES 结构描述 OEMForceFeedback 注册表项的“Attributes”值中包含的信息。
DIFFOBJECTATTRIBUTES DIFFOBJECTATTRIBUTES 结构描述强制回馈设备上每个“对象”注册表项的“FFAttributes”值中包含的信息。
DIHIDFFINITINFO DirectInput 使用 DIHIDFFINITINFO 结构向 HID 力回馈驱动程序提供有关要求其控制的设备的信息。
DIJOYCONFIG DIJOYCONFIG 结构包含有关游戏杆配置的信息。
DIJOYTYPEINFO DIJOYTYPEINFO 结构包含有关游戏杆类型的信息。
DIJOYUSERVALUES DIJOYUSERVALUES 结构包含有关用户游戏杆设置的信息。
DIOBJECTATTRIBUTES DIOBJECTATTRIBUTES 结构描述设备上每个“对象”的注册表项的“Attributes”值中包含的信息。 如果不存在“Attributes”值，则使用默认属性。
DIOBJECTCALIBRATION DIOBJECTCALIBRATION 结构描述设备上每个轴的注册表项的“校准”值中包含的信息。
JOYREGHWVALUES JOYREGHWVALUES (mmddk.h) 结构包含硬件返回的值范围， (校准) 填充。
JOYREGHWVALUES JOYREGHWVALUES (dinputd.h) 结构包含由校准) 填充的硬件 (返回的值范围。
KEYBOARD_ATTRIBUTES KEYBOARD_ATTRIBUTES指定键盘的属性。
KEYBOARD_EXTENDED_ATTRIBUTES KEYBOARD_EXTENDED_ATTRIBUTES指定键盘的扩展属性。
KEYBOARD_INDICATOR_PARAMETERS KEYBOARD_INDICATOR_PARAMETERS指定键盘指示器 LED 的状态。
KEYBOARD_INDICATOR_TRANSLATION KEYBOARD_INDICATOR_TRANSLATION指定键盘扫描代码和 LED 指示器之间的映射的特定于设备的可变长度数组。
KEYBOARD_INPUT_DATA KEYBOARD_INPUT_DATA包含一个键盘输入数据包。
KEYBOARD_TYPEMATIC_PARAMETERS KEYBOARD_TYPEMATIC_PARAMETERS指定键盘的键入设置。
KEYBOARD_UNIT_ID_PARAMETER KEYBOARD_UNIT_ID_PARAMETER指定 Kbdclass 分配给键盘的单元 ID。
MOUSE_ATTRIBUTES MOUSE_ATTRIBUTES指定鼠标设备的属性。
MOUSE_INPUT_DATA MOUSE_INPUT_DATA包含一个鼠标输入数据包。
MOUSE_UNIT_ID_PARAMETER MOUSE_UNIT_ID_PARAMETER指定 Mouclass 分配给鼠标的单元 ID。