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

言论

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

要求

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