IOCTL_USB_NOTIFY_ON_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)

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

Основной код

IRP_MJ_DEVICE_CONTROL

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

Элемент 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

См. также

создание запросов IOCTL в драйверах

драйверы USB-клиента для Media-Agnostic (MA-USB)

WdfIoTargetSendInternalIoctlOthersSynchronously

WdfIoTargetSendInternalIoctlSynchronous

WdfIoTargetSendIoctlSynchronously