IOCTL_HID_GET_PRODUCT_STRING IOCTL (hidclass.h)

Статья
02/26/2024

Запрос IOCTL_HID_GET_PRODUCT_STRING получает внедренную строку коллекции верхнего уровня , которая идентифицирует продукт производителя. Полученная строка — это строка с широкими символами, заканчивающаяся NULL, в понятном для человека формате.

Общие сведения об устройствах HIDClass [коллекции HID(/windows-hardware/drivers/hid/hid-collections).

Основной код

IRP_MJ_DEVICE_CONTROL

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

Parameters.DeviceIoControl.OutputBufferLength в расположении стека ввода-вывода IRP указывает размер выходного буфера в байтах. Если выходной буфер недостаточно велик для хранения всей строки, завершаемой null, запрос не возвращает ничего в выходном буфере.

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

Максимально возможное количество символов во внедренной строке зависит от устройства. Для USB-устройств максимальная длина строки составляет 126 символов в ширину (без учета завершающего символа NULL).

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

Irp->MdlAddress указывает на буфер для получения строки идентификатора продукта (строка расширенных символов с завершением NULL).

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

Длина строки расширенных символов с завершением NULL. Указанный буфер должен быть <= 4093 байта (2^12 –3).

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

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

Для сведений задается количество байтов, передаваемых с устройства.
Состояние устанавливается в STATUS_SUCCESS, если передача выполнена без ошибок. В противном случае устанавливается соответствующий код ошибки NTSTATUS.