функция 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 (include Hidsdi.h) |
| библиотеки | Hid.lib |
| DLL | Hid.dll |