структура USAGE_PROPERTIES (winuser.h)

Содержит свойства устройства (глобальные элементы устройства HID, соответствующие использованию HID) для любого типа устройства ввода HID.

Синтаксис

typedef struct tagUSAGE_PROPERTIES {
  USHORT level;
  USHORT page;
  USHORT usage;
  INT32  logicalMinimum;
  INT32  logicalMaximum;
  USHORT unit;
  USHORT exponent;
  BYTE   count;
  INT32  physicalMinimum;
  INT32  physicalMaximum;
} USAGE_PROPERTIES, *PUSAGE_PROPERTIES;

Члены

level

Значение, зависящее от использования, для линейного элемента управления на основе диапазона (ручка или циферблат), элемента управления включением и выключением (переключатель), мгновенного элемента управления (кнопка мыши), элемента управления с одним выстрелом (кнопка, активирующая одно событие) или повторного запуска элемента управления (кнопка, активирующая повторяющееся событие).

page

Идентификатор страницы использования, например страница элементов управления виртуальной реальностью (0x03) или страница управления игрой (0x05).

usage

Идентификатор использования, связанный со страницей использования, например поворот вправо/влево (21) или перемещение вправо/влево (24) для страницы управления игрой.

logicalMinimum

Наименьшее значение, которое может сообщить элемент управления.

logicalMaximum

Наибольшее значение, которое может сообщить элемент управления.

unit

Стандарт меры, используемый для описания физического значения элемента управления (после преобразования логического значения с помощью экспонентного значения). Спецификация HID определяет коды для базовых единиц длины, массы, времени, температуры, текущей и яркости.

exponent

Значение, используемое для масштабирования логического значения до физического.

count

Количество элементов данных, содержащихся в отчете.

physicalMinimum

LogicalMinimum, выраженный в физических единицах (преобразуется путем умножения logicalMinimum на экспоненту).

physicalMaximum

LogicalMaximum, выраженный в физических единицах (преобразуется путем умножения logicalMaximum на экспоненту).

Комментарии

Рабочая группа HID публикует набор документов, составляющих таблицы использования HID (словарь, описывающий, что разрешено делать устройствам HID). Эти таблицы использования HID содержат список с описаниями использования. Параметр Использование предоставляет разработчикам приложений сведения о предполагаемом значении и использовании определенного элемента, описанного в дескрипторове отчета. Например, для левой кнопки мыши определен параметр Usage (Использование). Дескриптор отчета может определить, где в отчете приложение может найти текущее состояние левой кнопки мыши. Таблицы использования разбиты на несколько пробелов имен, называемых страницами использования. Каждая страница использования описывает набор связанных сведений об использовании, которые помогут упорядочить документ. Сочетание страницы использования и использования определяет идентификатор использования, который однозначно идентифицирует конкретное использование в таблицах использования.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10, версия 1809 [только классические приложения]
Минимальная версия сервера	Windows Server [только классические приложения]
Верхняя часть	winuser.h

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

Таблицы использования HID универсальной последовательной шины — USB.org