IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)

此请求注册有关传输特征更改的通知。

主要代码

IRP_MJ_DEVICE_CONTROL

输入/输出缓冲区

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

另请参阅

在驱动程序中创建 IOCTL 请求

不区分媒体的 (MA-USB) 协议的客户端驱动程序

WdfIoTargetSendInternalIoctlOthersSynchronously

WdfIoTargetSendInternalIoctlSynchronously

WdfIoTargetSendIoctlSynchronously