IOCTL_USB_NOTIFY_ON_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)
This request notifies the caller of change in transport characteristics.
Major code
Input / Output buffer
The AssociatedIrp.SystemBuffer member is a pointer to a caller-allocated USB_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION structure. On input the caller passes the registration handle retrieved in the previous IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE request. On output, the structure is filled with the latest information about the type of information for which the caller.
Input / Output buffer length
The size of the USB_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION structure.
Status block
Irp->IoStatus.Status is set to STATUS_SUCCESS if the request is successful. Otherwise, Status indicates the appropriate error condition as a NTSTATUS code.
Remarks
This request is kept pending by the USB driver stack until a there is a change in the transport characteristics for which the caller registered. On completion of this request, the USB driver stack returns the information in the output buffer.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10, version 1709 |
| Minimum supported server | Windows Server 2016 |
| Header | usbioctl.h |
| IRQL | <=DISPATCH_LEVEL |
See also
Creating IOCTL Requests in Drivers
USB client drivers for Media-Agnostic (MA-USB)
WdfIoTargetSendInternalIoctlOthersSynchronously