EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS回调函数 (ucxcontroller.h)

UCX 调用此回调以检索主机控制器特征。

语法

EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS EvtUcxControllerGetTransportCharacteristics;

NTSTATUS EvtUcxControllerGetTransportCharacteristics(
  [in]  UCXCONTROLLER UcxController,
  [out] PUCX_CONTROLLER_TRANSPORT_CHARACTERISTICS UcxControllerTransportCharacteristics
)
{...}

参数

[in] UcxController

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

[out] UcxControllerTransportCharacteristics

指向主机控制器客户端驱动程序填充传输特征的 UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS 结构的指针。

返回值

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

言论

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

此回调函数是可选的。 每当传输特征发生更改时,客户端驱动程序将负责通知 UCX,其中一个特征已使用新函数 UcxControllerNotifyTransportCharacteristicsChange

要求

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

另请参阅

UcxControllerCreate