ucxusbdevice.h 标头

此标头用于写入 USB 主机控制器驱动程序。 USB 主机控制器扩展是系统提供的驱动程序 (Ucx01000.sys) 。 此驱动程序是通过使用 Windows 驱动程序框架编程接口作为框架类扩展实现的。 主机控制器驱动程序充当该类扩展的客户端驱动程序。 当主机控制器驱动程序处理硬件操作和事件、电源管理和 PnP 事件时,UCX 充当抽象接口,将请求排队到主机控制器驱动程序,并执行其他任务。

请勿直接包含此标头。 请改为包含 Ucxclass.h

有关详细信息,请参阅:

ucxusbdevice.h 包含以下编程接口:

函数

 
UCX_USBDEVICE_EVENT_CALLBACKS_INIT

使用指向客户端驱动程序回调函数的函数指针初始化 UCX_USBDEVICE_EVENT_CALLBACKS 结构。
UcxUsbDeviceCreate

在指定的控制器上创建 USB 设备对象。
UcxUsbDeviceInitSetEventCallbacks

使用客户端驱动程序的事件回调函数初始化 UCXUSBDEVICE_INIT 结构。
UcxUsbDeviceRemoteWakeNotification

通知 UCX 收到来自设备的远程唤醒信号。

回调函数

 
EVT_UCX_USBDEVICE_ADDRESS

UCX 调用以寻址 USB 设备的客户端驱动程序实现。
EVT_UCX_USBDEVICE_DEFAULT_ENDPOINT_ADD

客户端驱动程序的实现,UCX 调用该实现来为 USB 设备添加新的默认终结点。
EVT_UCX_USBDEVICE_DISABLE

UCX 调用的客户端驱动程序实现,用于释放与设备及其默认终结点关联的控制器资源。
EVT_UCX_USBDEVICE_ENABLE

客户端驱动程序的实现,UCX 将有关设备及其默认控制终结点的程序信息调用到控制器中。
EVT_UCX_USBDEVICE_ENDPOINT_ADD

UCX 调用来为 USB 设备添加新终结点的客户端驱动程序实现。
EVT_UCX_USBDEVICE_ENDPOINTS_CONFIGURE

UCX 调用以在控制器中配置终结点的客户端驱动程序实现。
EVT_UCX_USBDEVICE_GET_CHARACTERISTIC

UCX 调用此回调以检索设备特征。
EVT_UCX_USBDEVICE_HUB_INFO

UCX 调用以检索中心属性的客户端驱动程序实现。
EVT_UCX_USBDEVICE_RESET

重置设备所附加到的端口时,UCX 调用的客户端驱动程序实现。
EVT_UCX_USBDEVICE_RESUME

UCX 调用此回调函数以恢复设备从挂起状态。
EVT_UCX_USBDEVICE_SUSPEND

UCX 调用此回调函数以发送设备挂起状态。
EVT_UCX_USBDEVICE_UPDATE

UCX 调用以更新设备属性的客户端驱动程序实现。

结构

 
ADDRESS0_OWNERSHIP_ACQUIRE

包含用于配置设备的参数。
UCX_USBDEVICE_CHARACTERISTIC

存储设备的特征。
UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY

了解UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY如何存储常时等量传输路径延迟值。
UCX_USBDEVICE_EVENT_CALLBACKS

此结构提供 UCX USB 设备事件回调函数的列表。
UCXUSBDEVICE_INFO

包含有关 USB 设备的信息。 此结构由 UCX 在 EVT_UCX_CONTROLLER_USBDEVICE_ADD 事件回调函数中传递。
USB_DEVICE_PORT_PATH

包含 USB 设备的端口路径。
USBDEVICE_ABORTIO

包含要中止数据传输的通用串行总线 (USB) 集线器或设备的句柄。
USBDEVICE_ADDRESS

包含用于将指定设备转换为“已寻址”状态的请求的参数。 此结构由 UCX 在请求参数 (parameters.Others.Arg1) EVT_UCX_USBDEVICE_ADDRESS回调函数的框架请求对象中传递。
USBDEVICE_DISABLE

包含用于禁用指定设备的请求的参数。 此结构由 UCX 在请求参数 (parameters.Others.Arg1 中传递,) EVT_UCX_USBDEVICE_DISABLE回调函数的框架请求对象。
USBDEVICE_ENABLE

包含用于启用指定设备的请求的参数。 此结构由 UCX 在请求参数中传递, (parameters.Others.Arg1) EVT_UCX_USBDEVICE_ENABLE回调函数的框架请求对象。
USBDEVICE_ENABLE_FAILURE_FLAGS

客户端驱动程序在 EVT_UCX_USBDEVICE_ENABLE 回调函数中设置的标志。 指示启用设备时可能发生的错误(如果有)。
USBDEVICE_HUB_INFO

包含请求的参数,用于获取有关指定中心的信息。 此结构由 UCX 在请求参数中传递, (parameters.Others.Arg1) EVT_UCX_USBDEVICE_HUB_INFO回调函数的框架请求对象。
USBDEVICE_MGMT_HEADER

此结构为物理连接到总线的通用串行总线 (USB) 集线器或设备提供句柄。
USBDEVICE_PURGEIO

USBDEVICE_PURGEIO 结构包含要清除其 I/O 的通用串行总线 (USB) 集线器或设备的句柄。
USBDEVICE_RESET

包含重置指定设备的请求的参数。 此结构由 UCX 在请求参数中传递, (parameters.Others.Arg1) EVT_UCX_USBDEVICE_RESET回调函数的框架请求对象。
USBDEVICE_STARTIO

包含用于启动数据传输的通用串行总线 (USB) 集线器或设备的句柄。
USBDEVICE_TREE_PURGEIO

此结构提供通用串行总线 (USB) 设备树的句柄,以清除其 I/O。
USBDEVICE_UPDATE

由 UCX 传递以更新指定的设备。 此结构位于EVT_UCX_USBDEVICE_UPDATE回调函数中传递的框架请求对象的 Parameters.Others.Arg1 (请求参数) 中。
USBDEVICE_UPDATE_20_HARDWARE_LPM_PARAMETERS

包含用于更新 USB 2.0 链路电源管理 (LPM) 的请求的参数。 UCX 在 EVT_UCX_USBDEVICE_UPDATE 回调函数中传递此结构。
USBDEVICE_UPDATE_FAILURE_FLAGS

客户端驱动程序在 EVT_UCX_USBDEVICE_UPDATE 回调函数中设置的标志。 指示更新设备时可能发生的错误(如果有)。
USBDEVICE_UPDATE_FLAGS

包含 UCX 设置的请求标志,当 UCX 调用客户端驱动程序的 EVT_UCX_USBDEVICE_UPDATE 回调函数时,这些标志在 USBDEVICE_UPDATE 结构中传递。

枚举

 
UCX_USBDEVICE_CHARACTERISTIC_TYPE

定义指示设备特征类型的值。
UCX_USBDEVICE_RECOVERY_ACTION

定义 FLDR 和 PLDR 触发器重置的值。