Справочник по устройствам с человеческим интерфейсом

Обзор справочника по технологиям устройств HID.

Для разработки устройств с человеческим интерфейсом вам потребуются следующие заголовки:

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

Руководство по программированию драйверов HID см. в следующих разделах:

• Общие сведения об устройствах hid
• API-интерфейсы hid для устройств с человеческим интерфейсом (HID) драйверов Windows

Функции 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 возвращает сведения об атрибутах мыши.

Функции

Acquire Метод IDirectInputJoyConfig8::Acquire получает "режим конфигурации джойстика". Одновременно в режиме конфигурации джойстика может находиться только одно приложение; Последующие попытки других приложений получить этот режим должны получать ошибку DIERR_OTHERAPPHASPRIO. После входа в режим конфигурации приложение может вносить изменения в параметры конфигурации глобального джойстика. Приложение должно проверка существующие параметры перед установкой новых на случай изменения параметров другим приложением.
AddNewHardware Метод IDirectInputJoyConfig8::AddNewHardware отображает диалоговое окно Добавление нового оборудования, которое поможет пользователю установить новое устройство ввода.
AddRef Метод IDirectInputEffectDriver::AddRef увеличивает число ссылок объекта DirectInputEffectDriver на 1. Этот метод является частью интерфейса IUnknown, наследуемого DirectInputEffectDriver.
AddRef Метод IDirectInputJoyConfig8::AddRef увеличивает число ссылок объекта DirectInputJoyConfig на 1. Этот метод является частью интерфейса IUnknown, наследуемого DirectInputJoyConfig.
DeleteConfig Метод IDirectInputJoyConfig8::D eleteConfig удаляет сведения о конфигурации джойстика.
DeleteType Метод IDirectInputJoyConfig8::D eleteType удаляет сведения о типе джойстика. Используйте этот метод с осторожностью; ответственность за то, чтобы джойстик не ссылался на удаленный тип, отвечает вызывающий объект.
DestroyEffect Метод IDirectInputEffectDriver::D eeffect удаляет эффект с устройства. Если эффект воспроизводит, драйвер должен остановить его перед выгрузки.
DeviceID Метод IDirectInputEffectDriver::D eviceID отправляет драйверу удостоверение устройства.
DownloadEffect Метод IDirectInputEffectDriver::D ownloadEffect отправляет эффект на устройство.
EnumTypes Метод IDirectInputJoyConfig8::EnumTypes перечисляет типы джойстиков, поддерживаемые в настоящее время DirectInput.
ESCAPE Метод 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. Этот метод является частью интерфейса IUnknown, наследуемого DirectInputEffectDriver.
Выпуск Метод IDirectInputJoyConfig8::Release уменьшает количество ссылок объекта DirectInputJoyConfig на 1. Этот метод является частью интерфейса IUnknown, наследуемого DirectInputJoyConfig.
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 отменяет запрос режима конфигурации джойстика.

Интерфейсы

IDirectInputEffectDriver Эти три метода позволяют добавлять дополнительные интерфейсы в объект DirectInputEffectDriver, не влияя на функциональность исходного интерфейса.
IDirectInputJoyConfig8 Интерфейс IDirectInputJoyConfig8 содержит методы, позволяющие разработчикам оборудования, которые записывают листы свойств, записывать и считывать сведения в реестр и из реестра.

Структуры

DIDEVICESTATE Структура DIDEVICESTATE возвращает сведения о состоянии устройства принудительной обратной связи.
DIDRIVERVERSIONS Структура DIDRIVERVERSIONS используется драйвером эффекта DirectInput для передачи сведений о версии в DirectInput.
DIEFFECTATTRIBUTES Структура DIEFFECTATTRIBUTES описывает сведения, содержащиеся в значении "Атрибуты" раздела реестра для каждого эффекта, поддерживаемого устройством принудительной обратной связи.
DIEFFESCAPE Структура DIEFFESCAPE передает данные, относящиеся к оборудованию, непосредственно драйверу устройства.
DIFFDEVICEATBUTES Структура DIFFDEVICEATTRIBUTES описывает сведения, содержащиеся в значении Attributes раздела реестра OEMForceFeedback.
DIFFOBJECTATTRIBUTES Структура DIFFOBJECTATTRIBUTES описывает сведения, содержащиеся в значении "FFAttributes" раздела реестра для каждого "объекта" на устройстве принудительной обратной связи.
DIHIDFFINITINFO Структура DIHIDFFINITINFO используется DirectInput для предоставления сведений драйверу принудительной обратной связи HID об устройстве, которым он запрашивается управлять.
DIJOYCONFIG Структура DIJOYCONFIG содержит сведения о конфигурации джойстика.
DIJOYTYPEINFO Структура DIJOYTYPEINFO содержит сведения о типе джойстика.
DIJOYUSERVALUES Структура DIJOYUSERVALUES содержит сведения о параметрах джойстика пользователя.
DIOBJECTATTRIBUTES Структура DIOBJECTATTRIBUTES описывает сведения, содержащиеся в значении "Атрибуты" раздела реестра для каждого "объекта" на устройстве. Если значение "Атрибуты" отсутствует, используются атрибуты по умолчанию.
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 указывает состояние индикаторных индикаторов клавиатуры.
KEYBOARD_INDICATOR_TRANSLATION KEYBOARD_INDICATOR_TRANSLATION задает для конкретного устройства массив значений переменной длины для сопоставлений между кодами сканирования клавиатуры и светодиодными индикаторами.
KEYBOARD_INPUT_DATA KEYBOARD_INPUT_DATA содержит один пакет входных данных клавиатуры.
KEYBOARD_TYPEMATIC_PARAMETERS KEYBOARD_TYPEMATIC_PARAMETERS задает типтические параметры клавиатуры.
KEYBOARD_UNIT_ID_PARAMETER KEYBOARD_UNIT_ID_PARAMETER указывает идентификатор единицы измерения, который Kbdclass назначает клавиатуре.
MOUSE_ATTRIBUTES MOUSE_ATTRIBUTES задает атрибуты устройства мыши.
MOUSE_INPUT_DATA MOUSE_INPUT_DATA содержит один пакет входных данных с помощью мыши.
MOUSE_UNIT_ID_PARAMETER MOUSE_UNIT_ID_PARAMETER указывает идентификатор единицы измерения, который Mouclass назначает мыши.