通过

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

注解

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

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

要求

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

另请参阅

UcxControllerCreate