IOCTL_HID_GET_COLLECTION_INFORMATION IOCTL (hidclass.h)

Запрос IOCTL_HID_GET_COLLECTION_INFORMATION получает структуру HID_COLLECTION_INFORMATIONколлекции верхнего уровня. Эти сведения включают размер предварительно подготовленных данных коллекции в байтах.

Общие сведения об устройствах HIDClass см. в разделе Коллекции HID.

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

Parameters.DeviceIoControl.OutputBufferLength в расположении стека ввода-вывода IRP указывает размер выходного буфера в байтах, который должен иметь >значение = sizeof(HID_COLLECTION_INFORMATION).

Длина входного буфера

Больше или равно sizeof(HID_COLLECTION_INFORMATION).

Выходной буфер

Irp->AssociatedIrp.SystemBuffer указывает на буфер, который будет получать сведения о коллекции. Эти данные будут отформатированы в буфере, предоставленном инициатором запроса, в виде структуры HID_COLLECTION_INFORMATION.

Длина выходного буфера

Размер структуры HID_COLLECTION_INFORMATION.

Блок состояния

Драйвер класса HID задает следующие поля Irp-IoStatus>:

• Если данные были успешно извлечены, для сведений задано значение sizeof(HID_COLLECTION_INFORMATION).
• Состояние устанавливается в STATUS_SUCCESS, если передача выполнена без ошибок. В противном случае устанавливается соответствующий код ошибки NTSTATUS.

Требования

Требование	Значение
Заголовок	hidclass.h (включая Hidclass.h)

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

HID_COLLECTION_INFORMATION