Коллекции Top-Level

Коллекция верхнего уровня — это группа функциональных возможностей, предназначенная для конкретного потребителя программного обеспечения (или типа потребителя) функциональности. Например, коллекция верхнего уровня может быть описана как клавиатура, мышь, управление потребителем, датчик, дисплей и т. д. В спецификации HID эти коллекции верхнего уровня также называются коллекциями приложений. Устройство HID описывает назначение каждой коллекции верхнего уровня, чтобы позволить потребителям функций HID определить коллекции верхнего уровня, в которых они могут быть заинтересованы. В Windows класс настройки устройства HID (HIDClass) создает уникальный объект физического устройства (PDO) для каждой коллекции верхнего уровня, описанной в дескрипторе отчета. Корпорация Майкрософт определяет коллекцию верхнего уровня как коллекцию HID , которая не вложена в другую коллекцию. Неснеснутая коллекция всегда является коллекцией верхнего уровня, независимо от типа HID. В частности, коллекция верхнего уровня не обязательно должна быть коллекцией Приложений , как определено стандартом USB HID.

Дескриптор отчета может включать несколько коллекций верхнего уровня. Драйвер класса HID перечисляет коллекции верхнего уровня устройства ввода и создает объект физического устройства (PDO) для каждой коллекции верхнего уровня. Приложения пользовательского режима или драйверы режима ядра могут получить доступ к коллекции верхнего уровня, открыв ее PDO и используя подпрограммы поддержки HIDClass и IOCTL драйвера класса HID.

Внутренняя структура и возможности коллекции верхнего уровня описаны ниже.

• Структура HIDP_CAPS суммирует возможности коллекции верхнего уровня.

• Коллекции ссылок описывают организацию вложенных вложенных коллекций, содержащихся в коллекции верхнего уровня.

• Массивы возможностей кнопок и массивы возможностей значений описывают возможности элементов управления, поддерживаемых коллекцией верхнего уровня.