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

Подпрограмма HidD_GetPreparsedData возвращает подготовленные данныеколлекции верхнего уровня.

Синтаксис

BOOLEAN HidD_GetPreparsedData(
  [in]  HANDLE               HidDeviceObject,
  [out] PHIDP_PREPARSED_DATA *PreparsedData
);

Параметры

[in] HidDeviceObject

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

[out] PreparsedData

Указатель на адрес буфера, выделенного подпрограммой, который содержит подготовленные данные коллекции в структуре _HIDP_PREPARSED_DATA .

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

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

Комментарии

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

Если приложению больше не нужны подготовленные данные, оно должно вызвать HidD_FreePreparsedData , чтобы освободить подготовленный буфер данных.

Дополнительные сведения см. в разделе Коллекции HID.

Требования

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

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

HidD_FreePreparsedData

IOCTL_HID_GET_COLLECTION_DESCRIPTOR

_HIDP_PREPARSED_DATA