通过

EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION回调函数 （ucxcontroller.h）

  • 项目

UCX 调用此回调函数，以指定客户端驱动程序在发生更改时必须向其发送通知的传输特征中的首选项。

语法

EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION EvtUcxControllerSetTransportCharacteristicsChangeNotification;

void EvtUcxControllerSetTransportCharacteristicsChangeNotification(
  [in] UCXCONTROLLER UcxController,
  [in] UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS ChangeNotificationFlags
)
{...}

参数

[in] UcxController

客户端驱动程序在对 UcxControllerCreate 方法的上一次调用中收到的 UCX 控制器的句柄。

[in] ChangeNotificationFlags

指示 UCX 感兴趣的类型传输特征的标志的按位选项。 标志在 UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS中定义。

返回值

没有

言论

如果作成功，回调函数必须返回STATUS_SUCCESS，或NT_SUCCESS（status） 等于 TRUE 的另一个状态值。 否则，它必须返回NT_SUCCESS（status）等于 FALSE 的状态值。

UCX 客户端驱动程序通过调用 UcxControllerCreate 方法向 USB 主机控制器扩展（UCX）注册其实现。

为了获得高效的能耗，UCX 调用此回调函数以指定 UCX 感兴趣的传输特征。

如果客户端驱动程序在控制器中不断查找传输特征的更改，则可能是这样。 这可能会导致高功率消耗，如果没有为该更改通知注册的 USB 设备驱动程序，则效率可能低下。 为了优化能耗，UCX 调用此回调函数，让客户端驱动程序知道是否已注册任何客户端进行更改。 此回调函数将更改通知标志作为参数传递。 如果设置了标志，则表示至少注册了一个设备驱动程序。 如果未设置标志，则表示没有注册客户端，因此控制器可以优化电源。

注意

控制器驱动程序注册或使用这些回调函数是可选的。 即使 UCX 指示没有为其注册客户端，控制器驱动程序也能够调用更改通知。

要求

要求 价值
最低支持的客户端 Windows 10 版本 1709
支持的最低服务器 Windows Server 2016
目标平台 窗户
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 ucxcontroller.h （include Ucxclass.h）
IRQL PASSIVE_LEVEL

另请参阅