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 (状态) 等于 TRUE 的另一个状态值。 否则，它必须返回一个状态值，NT_SUCCESS (状态) 等于 FALSE。

UCX 客户端驱动程序通过调用 UcxControllerCreate 方法将其实现注册到 USB 主控制器扩展 (UCX) 。

为了提高功耗，UCX 调用此回调函数来指定 UCX 感兴趣的传输特征。

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

注意

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

要求

要求	值
最低受支持的客户端	Windows 10 版本 1709
最低受支持的服务器	Windows Server 2016
目标平台	Windows
最低 KMDF 版本	1.0
最低 UMDF 版本	2.0
标头	ucxcontroller.h (包括 Ucxclass.h)
IRQL	PASSIVE_LEVEL

另请参阅

• UcxControllerCreate