IOCTL_USB_NOTIFY_ON_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)

Статья
08/07/2023

Этот запрос уведомляет вызывающий объект об изменении характеристик транспорта.

Основной код

Буфер входных и выходных данных

Элемент AssociatedIrp.SystemBuffer является указателем на структуру, выделенную вызывающим объектом USB_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION . При входе вызывающий объект передает дескриптор регистрации, полученный в предыдущем запросе IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE . В выходных данных структура заполняется последними сведениями о типе информации, для которой является вызывающий объект.

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

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

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

Irp->IoStatus.Status имеет значение STATUS_SUCCESS, если запрос выполнен успешно. В противном случае состояние указывает соответствующее условие ошибки в виде кода NTSTATUS .

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 версии 1709
Минимальная версия сервера	Windows Server 2016
Верхняя часть	usbioctl.h
IRQL	<=DISPATCH_LEVEL