usbioctl.h 标头

usbref 使用此标头。 有关详细信息，请参阅：

• 通用串行总线 (USB)

usbioctl.h 包含以下编程接口：

IOCTL

IOCTL_GET_HCD_DRIVERKEY_NAME IOCTL_GET_HCD_DRIVERKEY_NAME I/O 控制请求在注册表中检索 USB 主机控制器驱动程序的驱动程序密钥名称。
IOCTL_INTERNAL_USB_CYCLE_PORT IOCTL_INTERNAL_USB_CYCLE_PORT I/O 请求模拟设备拔出并重新插上与 PDO 关联的端口。
IOCTL_INTERNAL_USB_ENABLE_PORT IOCTL_INTERNAL_USB_ENABLE_PORT IOCTL 已弃用。 请勿使用。
IOCTL_INTERNAL_USB_GET_BUS_INFO IOCTL_INTERNAL_USB_GET_BUS_INFO I/O 请求在总线驱动程序中查询某些总线信息。
IOCTL_INTERNAL_USB_GET_BUSGUID_INFO IOCTL_INTERNAL_USB_GET_BUSGUID_INFO IOCTL 已弃用。 请勿使用。
IOCTL_INTERNAL_USB_GET_CONTROLLER_NAME IOCTL_INTERNAL_USB_GET_CONTROLLER_NAME I/O 请求在总线驱动程序中查询 USB 主机控制器的设备名称。
IOCTL_INTERNAL_USB_GET_DEVICE_CONFIG_INFO IOCTL_INTERNAL_USB_GET_DEVICE_CONFIG_INFO I/O 请求返回有关 USB 设备及其连接到的集线器的信息。
IOCTL_INTERNAL_USB_GET_DEVICE_HANDLE IOCTL_INTERNAL_USB_GET_DEVICE_HANDLE IOCTL 由 USB 集线器驱动程序使用。 请勿使用。
IOCTL_INTERNAL_USB_GET_DEVICE_HANDLE_EX IOCTL_INTERNAL_USB_GET_DEVICE_HANDLE_EX IOCTL 由 USB 集线器驱动程序使用。 请勿使用。
IOCTL_INTERNAL_USB_GET_HUB_COUNT IOCTL_INTERNAL_USB_GET_HUB_COUNT IOCTL 由 USB 集线器驱动程序使用。 请勿使用。
IOCTL_INTERNAL_USB_GET_HUB_NAME 如果 PDO 用于中心，则驱动程序使用IOCTL_INTERNAL_USB_GET_HUB_NAME I/O 请求来检索目标 PDO 的 UNICODE 符号名称。
IOCTL_INTERNAL_USB_GET_PARENT_HUB_INFO IOCTL_INTERNAL_USB_GET_PARENT_HUB_INFO由 USB 集线器驱动程序使用。 请勿使用。
IOCTL_INTERNAL_USB_GET_PORT_STATUS IOCTL_INTERNAL_USB_GET_PORT_STATUS I/O 请求查询 PDO 的状态。 IOCTL_INTERNAL_USB_GET_PORT_STATUS是内核模式 I/O 控制请求。 此请求面向 USB 集线器 PDO。 必须在 IRQL = PASSIVE_LEVEL 发送此 IOCTL。
IOCTL_INTERNAL_USB_GET_ROOTHUB_PDO IOCTL_INTERNAL_USB_GET_ROOTHUB_PDO IOCTL 由 USB 中心驱动程序使用。 请勿使用。
IOCTL_INTERNAL_USB_GET_TOPOLOGY_ADDRESS IOCTL_INTERNAL_USB_GET_TOPOLOGY_ADDRESS I/O 请求返回有关 USB 设备连接到的主控制器的信息，以及设备在 USB 设备树中的位置。
IOCTL_INTERNAL_USB_GET_TT_DEVICE_HANDLE USB 集线器驱动程序使用IOCTL_INTERNAL_USB_GET_TT_DEVICE_HANDLE。 请勿使用。
IOCTL_INTERNAL_USB_NOTIFY_IDLE_READY IOCTL_INTERNAL_USB_NOTIFY_IDLE_READY IOCTL 由 USB 中心驱动程序使用。 请勿使用。
IOCTL_INTERNAL_USB_RECORD_FAILURE IOCTL_INTERNAL_USB_RECORD_FAILURE IOCTL 由 USB 中心驱动程序使用。 请勿使用。
IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE I/O 请求将 USB 多功能设备的驱动程序 (复合驱动程序) 注册到基础 USB 驱动程序堆栈。
IOCTL_INTERNAL_USB_REQ_GLOBAL_RESUME IOCTL_INTERNAL_USB_REQ_GLOBAL_RESUME IOCTL 由 USB 中心驱动程序使用。 请勿使用。
IOCTL_INTERNAL_USB_REQ_GLOBAL_SUSPEND IOCTL_INTERNAL_USB_REQ_GLOBAL_SUSPEND IOCTL 由 USB 集线器驱动程序使用。 请勿使用。
IOCTL_INTERNAL_USB_REQUEST_REMOTE_WAKE_NOTIFICATION IOCTL_INTERNAL_USB_REQUEST_REMOTE_WAKE_NOTIFICATION I/O 请求由通用串行总线 (USB) 多功能设备的驱动程序发送， (复合驱动程序) 从设备中的特定功能请求远程唤醒通知。
IOCTL_INTERNAL_USB_RESET_PORT 驱动程序使用IOCTL_INTERNAL_USB_RESET_PORT I/O 控制请求重置其所管理设备的上游端口。
IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION 驱动程序使用IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION I/O 请求来通知 USB 总线驱动程序设备处于空闲状态并可以挂起。
IOCTL_INTERNAL_USB_SUBMIT_URB 驱动程序使用IOCTL_INTERNAL_USB_SUBMIT_URB I/O 控制请求将 URB 提交到总线驱动程序。 IOCTL_INTERNAL_USB_SUBMIT_URB是内核模式 I/O 控制请求。 此请求面向 USB 集线器 PDO。
IOCTL_INTERNAL_USB_UNREGISTER_COMPOSITE_DEVICE IOCTL_INTERNAL_USB_UNREGISTER_COMPOSITE_DEVICE I/O 请求取消注册 USB 多功能设备的驱动程序 (复合驱动程序) ，并释放与注册关联的所有资源。
IOCTL_USB_DIAG_IGNORE_HUBS_OFF IOCTL_USB_DIAG_IGNORE_HUBS_OFF I/O 控件已弃用。 请勿使用。
IOCTL_USB_DIAG_IGNORE_HUBS_ON IOCTL_USB_DIAG_IGNORE_HUBS_ON I/O 控件已弃用。 请勿使用。
IOCTL_USB_DIAGNOSTIC_MODE_OFF IOCTL_USB_DIAGNOSTIC_MODE_OFF I/O 控件已弃用。 请勿使用。
IOCTL_USB_DIAGNOSTIC_MODE_ON IOCTL_USB_DIAGNOSTIC_MODE_ON I/O 控件已弃用。 请勿使用。
IOCTL_USB_GET_DESCRIPTOR_FROM_NODE_CONNECTION IOCTL_USB_GET_DESCRIPTOR_FROM_NODE_CONNECTION I/O 控制请求检索与指示的端口索引关联的设备的一个或多个描述符。IOCTL_USB_GET_DESCRIPTOR_FROM_NODE_CONNECTION是用户模式 I/O 控制请求。
IOCTL_USB_GET_DEVICE_CHARACTERISTICS 客户端驱动程序发送此请求以确定 USB 设备的常规特征，例如任何请求的最大发送和接收延迟。
IOCTL_USB_GET_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC IOCTL_USB_GET_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC IOCTL 函数获取系统查询性能计数器 (特定帧和微帧的 QPC) 值。
IOCTL_USB_GET_HUB_CAPABILITIES IOCTL_USB_GET_HUB_CAPABILITIES I/O 控制请求检索 USB 集线器的功能。
IOCTL_USB_GET_HUB_CAPABILITIES_EX IOCTL_USB_GET_HUB_CAPABILITIES_EX I/O 控制请求检索 USB 集线器的功能。IOCTL_USB_GET_HUB_CAPABILITIES_EX是用户模式 I/O 控制请求。 此请求面向 USB 集线器设备 (GUID_DEVINTERFACE_USB_HUB) 。
IOCTL_USB_GET_HUB_INFORMATION_EX IOCTL_USB_GET_HUB_INFORMATION_EX I/O 控制请求由应用程序发送，以检索有关USB_HUB_INFORMATION_EX结构中的 USB 集线器的信息。请求检索中心上的最高端口号。
IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES I/O 控制请求检索特定端口的 Microsoft 扩展端口属性。
IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME I/O 控制请求检索与连接到所指示端口的设备关联的驱动程序注册表项名称。
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION IOCTL_USB_GET_NODE_CONNECTION_INFORMATION请求检索有关指示的 USB 端口和连接到端口的设备（如果有） 的信息。客户端驱动程序必须在 IRQL PASSIVE_LEVEL 发送此 IOCTL。IOCTL_USB_GET_NODE_CONNECTION_INFORMATION是用户模式 I/O 控制请求。 此请求面向 USB 集线器设备 (GUID_DEVINTERFACE_USB_HUB) 。 不要将此请求发送到根中心。
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX请求检索有关 USB 端口和连接到端口的设备（如果有） 的信息。客户端驱动程序必须在 IRQL PASSIVE_LEVEL 发送此 IOCTL。IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX是用户模式 I/O 控制请求。 此请求面向 USB 集线器设备 (GUID_DEVINTERFACE_USB_HUB) 。 不要将此请求发送到根中心。
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX_V2 IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX_V2 I/O 控件由应用程序发送，用于检索集线器上特定 USB 端口支持的协议的相关信息。 请求还会检索端口的速度功能。
IOCTL_USB_GET_NODE_CONNECTION_NAME IOCTL_USB_GET_NODE_CONNECTION_NAME I/O 控制请求与 USB_NODE_CONNECTION_NAME 结构一起使用，以检索附加到下游端口的中心符号链接名称。IOCTL_USB_GET_NODE_CONNECTION_NAME是用户模式 I/O 控制请求。 此请求面向 USB 集线器设备 (GUID_DEVINTERFACE_USB_HUB) 。
IOCTL_USB_GET_NODE_INFORMATION IOCTL_USB_GET_NODE_INFORMATION I/O 控制请求与 USB_NODE_INFORMATION 结构一起使用，以检索有关父设备的信息。IOCTL_USB_GET_NODE_INFORMATION是用户模式 I/O 控制请求。
IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIES IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIES I/O 控制请求由应用程序发送，以检索有关 USB 集线器上特定端口的信息。
IOCTL_USB_GET_ROOT_HUB_NAME IOCTL_USB_GET_ROOT_HUB_NAME I/O 控制请求与 USB_ROOT_HUB_NAME 结构一起使用，以检索根中心的符号链接名称。IOCTL_USB_GET_ROOT_HUB_NAME是用户模式 I/O 控制请求。
IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS 客户端驱动程序发送此请求以检索传输特征。
IOCTL_USB_HCD_DISABLE_PORT IOCTL_USB_HCD_DISABLE_PORT IOCTL 已弃用。 请勿使用。
IOCTL_USB_HCD_ENABLE_PORT IOCTL_USB_HCD_ENABLE_PORT IOCTL 已弃用。 请勿使用。
IOCTL_USB_HCD_GET_STATS_1 IOCTL_USB_HCD_GET_STATS_1 IOCTL 已弃用。 请勿使用。
IOCTL_USB_HCD_GET_STATS_2 IOCTL_USB_HCD_GET_STATS_2 IOCTL 已弃用。 请勿使用。
IOCTL_USB_HUB_CYCLE_PORT IOCTL_USB_HUB_CYCLE_PORT I/O 控制请求对与接收请求的 PDO 关联的端口进行电源循环。
IOCTL_USB_NOTIFY_ON_TRANSPORT_CHARACTERISTICS_CHANGE 此请求通知调用方传输特征的更改。
IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE 此请求注册有关传输特征更改的通知。
IOCTL_USB_RESET_HUB IOCTL_USB_RESET_HUB IOCTL 由 USB 驱动程序堆栈使用。 请勿使用。
IOCTL_USB_START_TRACKING_FOR_TIME_SYNC 此请求将调用方注册到用于时间同步服务的 USB 驱动程序堆栈。
IOCTL_USB_STOP_TRACKING_FOR_TIME_SYNC 此请求使用 USB 驱动程序堆栈取消注册时间同步服务的调用方。
IOCTL_USB_UNREGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE 此请求取消注册调用方，无法获取有关传输特征更改的通知。

结构

HUB_DEVICE_CONFIG_INFO HUB_DEVICE_CONFIG_INFO 结构与内核模式 IOCTL 结合使用，IOCTL_INTERNAL_USB_GET_DEVICE_CONFIG_INFO请求报告有关 USB 设备和设备所连接到的集线器的信息。
USB_BUS_NOTIFICATION 详细了解：_USB_BUS_NOTIFICATION结构
USB_CYCLE_PORT_PARAMS USB_CYCLE_PORT_PARAMS 结构与 IOCTL_USB_HUB_CYCLE_PORT I/O 控制请求一起使用，以便对与接收请求的 PDO 关联的端口进行电源循环。
USB_DESCRIPTOR_REQUEST USB_DESCRIPTOR_REQUEST 结构与 IOCTL_USB_GET_DESCRIPTOR_FROM_NODE_CONNECTION I/O 控制请求一起使用，以检索与指示的连接索引关联的设备的一个或多个描述符。
USB_DEVICE_CHARACTERISTICS 包含有关 USB 设备特征的信息，例如任何请求的最大发送和接收延迟。 此结构用于IOCTL_USB_GET_DEVICE_CHARACTERISTICS请求。
USB_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC_INFORMATION 存储帧和微帧数以及计算的系统 QPC 值。 此结构用于IOCTL_USB_GET_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC请求。
USB_HCD_DRIVERKEY_NAME USB_HCD_DRIVERKEY_NAME 结构与 IOCTL_GET_HCD_DRIVERKEY_NAME I/O 控制请求一起使用，以检索 USB 主机控制器驱动程序的注册表中的驱动程序密钥。
USB_HUB_CAP_FLAGS USB_HUB_CAP_FLAGS结构用于报告中心的功能。
USB_HUB_CAPABILITIES USB_HUB_CAPABILITIES 结构已弃用。 请改用 USB_HUB_CAPABILITIES_EX。
USB_HUB_CAPABILITIES_EX USB_HUB_CAPABILITIES_EX 结构与 IOCTL_USB_GET_HUB_CAPABILITIES I/O 控制请求一起使用，以检索特定 USB 集线器的功能。
USB_HUB_INFORMATION USB_HUB_INFORMATION结构包含有关中心的信息。
USB_HUB_INFORMATION_EX USB_HUB_INFORMATION_EX 结构与 IOCTL_USB_GET_HUB_INFORMATION_EX I/O 控制请求一起使用，以检索有关 USB) 集线器 (通用串行总线的信息。
USB_HUB_NAME USB_HUB_NAME结构存储中心的符号设备名称。
USB_ID_STRING USB_ID_STRING 结构用于存储字符串或多字符串。
USB_MI_PARENT_INFORMATION USB_MI_PARENT_INFORMATION结构包含有关复合设备的信息。
USB_NODE_CONNECTION_ATTRIBUTES USB_NODE_CONNECTION_ATTRIBUTES 结构与 IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES I/O 控制请求一起使用，以检索连接的属性。
USB_NODE_CONNECTION_DRIVERKEY_NAME USB_NODE_CONNECTION_DRIVERKEY_NAME 结构与 IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME I/O 控制请求一起使用，以检索连接到所指示端口的设备的驱动程序密钥名称。
USB_NODE_CONNECTION_INFORMATION USB_NODE_CONNECTION_INFORMATION结构与IOCTL_USB_GET_NODE_CONNECTION_INFORMATION请求一起使用，以检索有关 USB 端口和已连接设备的信息。
USB_NODE_CONNECTION_INFORMATION_EX USB_NODE_CONNECTION_INFORMATION_EX 结构与 IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX 请求结合使用，以获取有关与指示的 USB 端口关联的连接的信息。
USB_NODE_CONNECTION_INFORMATION_EX_V2 USB_NODE_CONNECTION_INFORMATION_EX_V2 结构与 IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX_V2 I/O 控制请求一起使用，以检索连接到特定端口的通用串行总线 (USB) 设备的速度信息。
USB_NODE_CONNECTION_INFORMATION_EX_V2_FLAGS USB_NODE_CONNECTION_INFORMATION_EX_V2_FLAGS联合用于指示 USB 3.0 设备当前运行的速度，以及连接到特定端口时是否可以以更高的速度运行。
USB_NODE_CONNECTION_NAME USB_NODE_CONNECTION_NAME 结构与 IOCTL_USB_GET_NODE_CONNECTION_NAME I/O 控制请求一起使用，以检索附加到端口的下游中心的符号链接。
USB_NODE_INFORMATION USB_NODE_INFORMATION 结构与 IOCTL_USB_GET_NODE_INFORMATION I/O 控制请求一起使用，以检索有关父设备的信息。
USB_PIPE_INFO USB_PIPE_INFO 结构与 USB_NODE_CONNECTION_INFORMATION_EX 结构和 IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX 请求结合使用，以获取有关连接及其关联管道的信息。
USB_PORT_CONNECTOR_PROPERTIES USB_PORT_CONNECTOR_PROPERTIES 结构与 IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIES I/O 控制请求一起使用，以检索有关特定 SuperSpeed 中心上的端口的信息。
USB_PORT_PROPERTIES USB_PORT_PROPERTIES联合用于报告通用串行总线 (USB) 端口的功能。IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIES I/O 控制请求在USB_PORT_CONNECTOR_PROPERTIES结构中检索端口功能。
USB_PROTOCOLS USB_PROTOCOLS联合用于报告端口支持的通用串行总线 (USB) 信号协议。
USB_ROOT_HUB_NAME USB_ROOT_HUB_NAME结构存储根中心的符号设备名称。
USB_START_TRACKING_FOR_TIME_SYNC_INFORMATION IOCTL_USB_START_TRACKING_FOR_TIME_SYNC请求的输入和输出缓冲区。
USB_STOP_TRACKING_FOR_TIME_SYNC_INFORMATION IOCTL_USB_STOP_TRACKING_FOR_TIME_SYNC请求的输入缓冲区。
USB_TOPOLOGY_ADDRESS USB_TOPOLOGY_ADDRESS结构与IOCTL_INTERNAL_USB_GET_TOPOLOGY_ADDRESS I/O 请求一起使用，以检索有关 USB 设备在 USB 设备树中的位置的信息。
USB_TRANSPORT_CHARACTERISTICS 将传输特征存储在相关时间点。 此结构用于IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS请求。
USB_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION 包含IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE请求完成时填充的注册信息。
USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION 包含IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE请求的注册信息。
USB_TRANSPORT_CHARACTERISTICS_CHANGE_UNREGISTRATION 包含IOCTL_USB_UNREGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE请求的注销信息。

枚举

USB_CONNECTION_STATUS USB_CONNECTION_STATUS枚举器指示与 USB 集线器端口上的设备的连接状态。
USB_HUB_NODE USB_HUB_NODE枚举器指示设备是中心设备还是复合设备。
USB_HUB_TYPE USB_HUB_TYPE 枚举定义指示 USB 集线器类型的常量。 中心类型由IOCTL_USB_GET_HUB_INFORMATION_EX I/O 控制请求检索。
USB_NOTIFICATION_TYPE 详细了解：_USB_NOTIFICATION_TYPE 枚举