IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)
此请求注册有关传输特征更改的通知。
主要代码
输入/输出缓冲区
AssociatedIrp.SystemBuffer 成员是指向USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION结构的指针。 输入时,客户端驱动程序可以通过在 ChangeNotificationInputFlags 成员中设置标志来指定驱动程序感兴趣的通知更改类型。
在输出时,结构填充了传输特征的注册句柄和初始值。
输入/输出缓冲区长度
USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION结构的大小。
状态块
Irp->如果请求成功,IoStatus.Status 设置为 STATUS_SUCCESS。 否则, Status 指示相应的错误条件作为 NTSTATUS 代码。
注解
MA-USB 介质的传输特征可能会随时间而变化很大。 如果客户端潜水员希望随时了解最新信息,驱动程序必须通过发送请求来注册通知。
此请求可由用户模式应用程序、UMDF 驱动程序或 KMDF 驱动程序发送。 USB 驱动程序堆栈检查过时和错误的注册句柄。 如果在注册前和取消注册后在句柄上收到请求,则驱动程序堆栈会失败请求。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 版本 1709 |
最低受支持的服务器 | Windows Server 2016 |
标头 | usbioctl.h |
IRQL | <=DISPATCH_LEVEL |
另请参阅
WdfIoTargetSendInternalIoctlOthersSynchronously