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 |