функция HidP_GetExtendedAttributes (hidpi.h)

Статья
02/07/2025

Подпрограмма HidP_GetExtendedAttributes возвращает расширенные атрибуты элемента управления HID.

Синтаксис

NTSTATUS HidP_GetExtendedAttributes(
  [in]      HIDP_REPORT_TYPE          ReportType,
  [in]      USHORT                    DataIndex,
  [in]      PHIDP_PREPARSED_DATA      PreparsedData,
  [out]     PHIDP_EXTENDED_ATTRIBUTES Attributes,
  [in, out] PULONG                    LengthAttributes
);

Параметры

[in] ReportType

Задает значение перечислителя HIDP_REPORT_TYPE, указывающее тип отчета HID, связанного с элементом управления HID, указанным DataIndex.

[in] DataIndex

Указывает индекс данных элемента управления HID.

[in] PreparsedData

Задает предварительно подготовленных данных для коллекции верхнего уровня, содержащей указанный элемент управления.

[out] Attributes

Указатель на выделенный вызывающим буфером, который подпрограмма использует для возврата расширенных атрибутов элемента управления, указанного DataIndex.

[in, out] LengthAttributes

Задает размер в байтах буфера атрибутов (который должен быть больше или равен размеру(HIDP_EXTENDED_ATTRIBUTES).

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

HidP_GetExtendedAttributes возвращает одно из следующих значений состояния:

Возвращаемый код	Описание
HIDP_STATUS_SUCCESS	Подпрограмма успешно вернула все сведения о расширенных атрибутах элемента управления.
HIDP_STATUS_BUFFER_TOO_SMALL	Буфер атрибутов недостаточно велик, чтобы хранить все сведения о расширенных атрибутах.
HIDP_STATUS_DATA_INDEX_NOT_FOUND	Указанный индекс данных недопустим.

Замечания

HidP_GetExtendedAttributes возвращает структуру переменной длины HIDP_EXTENDED_ATTRIBUTES в буфере атрибутов . Структура расширенных атрибутов содержит элементы фиксированной длины (NumGlobalUnknowns, Зарезервированныеи GlobalUnknowns), а затем массив переменной длины структур HIDP_UNKNOWN_TOKEN. Первый элемент массива неизвестных маркеров находится в&(PHIDP_UNKNOWN_TOKEN*) (атрибуты—>данных).

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

Дополнительные сведения см. в коллекциях HID.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows 2000 и более поздних версиях Windows.
целевая платформа	Всеобщий
заголовка	hidpi.h (include Hidpi.h)
библиотеки	Hidparse.lib
IRQL	<= уровень DISPATCH_

См. также

HIDP_EXTENDED_ATTRIBUTES

HIDP_UNKNOWN_TOKEN

_HIDP_PREPARSED_DATA

Поделиться через