EVT_UCX_USBDEVICE_GET_CHARACTERISTIC回调函数 (ucxusbdevice.h)

  • 项目

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

语法

EVT_UCX_USBDEVICE_GET_CHARACTERISTIC EvtUcxUsbdeviceGetCharacteristic;

NTSTATUS EvtUcxUsbdeviceGetCharacteristic(
  [in]      UCXCONTROLLER UcxController,
  [in]      UCXUSBDEVICE UcxUsbDevice,
  [in, out] PUCX_USBDEVICE_CHARACTERISTIC UcxUsbDeviceCharacteristic
)
{...}

参数

[in] UcxController

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

[in] UcxUsbDevice

UCX 对象的句柄，该对象表示客户端驱动程序在上一次调用 UcxUsbDeviceCreate 方法时收到的 USB 设备。

[in, out] UcxUsbDeviceCharacteristic

指向 UCX_USBDEVICE_CHARACTERISTIC 结构的指针，该结构包含调用方感兴趣的特征类型。 客户端驱动程序填充所请求特征的值。 例如，如果类型指示UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY，则驱动程序将使用相应的最大值和发送路径延迟值填充 pathDelay 成员指向的 UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY 结构。

返回值

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

注解

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

要求

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