Share via

функция HidD_SetFeature (hidsdi.h)

  • Статья

Подпрограмма HidD_SetFeature отправляет отчет о функциях в коллекцию верхнего уровня.

Синтаксис

BOOLEAN HidD_SetFeature(
  [in] HANDLE HidDeviceObject,
  [in] PVOID  ReportBuffer,
  [in] ULONG  ReportBufferLength
);

Параметры

[in] HidDeviceObject

Открытый дескриптор для коллекции верхнего уровня.

[in] ReportBuffer

Указатель на буфер отчета, выделенный вызывающим объектом, который используется вызывающим объектом для указания идентификатора отчета HID.

Дополнительные сведения об этом параметре см. в разделе Примечания .

[in] ReportBufferLength

Размер буфера отчета в байтах. Буфер отчета должен быть достаточно большим, чтобы вместить отчет о функциях плюс один дополнительный байт, указывающий ненулевой идентификатор отчета. Если идентификатор отчета не используется, значение идентификатора равно нулю.

Возвращаемое значение

Если HidD_SetFeature выполнено успешно, возвращается значение TRUE; в противном случае возвращается значение FALSE. Используйте GetLastError для получения расширенных сведений об ошибке.

Комментарии

Правильный объект ReportBufferLength определяется элементом FeatureReportByteLengthструктуры HIDP_CAPS коллекции верхнего уровня, возвращаемой из HidP_GetCaps вызова.

Перед вызовом подпрограммы HidD_SetFeature вызывающий объект должен выполнить следующие действия:

  • Если коллекция верхнего уровня содержит идентификаторы отчетов, вызывающий объект должен задать для первого байта параметра ReportBuffer ненулевого идентификатора отчета.
  • Если коллекция верхнего уровня не включает идентификаторы отчетов, вызывающий объект должен задать для первого байта параметра ReportBuffer значение 0.
  • На отчет о функциях ссылается параметр ReportBuffer . В зависимости от идентификатора отчета вызывающий объект подготавливает отчет, вызывая одну из следующих функций:

Пример подготовки и отчета HID и его отправки в коллекцию верхнего уровня см. в примере приложения HClient .

Только приложения в пользовательском режиме могут вызывать HidD_SetFeature. Драйверы в режиме ядра могут использовать запрос IOCTL_HID_SET_FEATURE .

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 2000 и более поздних версиях Windows.
Целевая платформа Универсальное
Верхняя часть hidsdi.h (включая Hidsdi.h)
Библиотека Hid.lib
DLL Hid.dll

См. также раздел