EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE回调函数 (udecxusbdevice.h)

USB 设备仿真类扩展 (UdeCx) 通过选择备用设置、禁用当前终结点或添加动态终结点来调用此回调函数来更改配置。

语法

EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE EvtUdecxUsbDeviceEndpointsConfigure;

void EvtUdecxUsbDeviceEndpointsConfigure(
  [in] UDECXUSBDEVICE UdecxUsbDevice,
  [in] WDFREQUEST Request,
  [in] PUDECX_ENDPOINTS_CONFIGURE_PARAMS Params
)
{...}

参数

[in] UdecxUsbDevice

UDE 设备对象的句柄。 客户端驱动程序在上一次调用 UdecxUsbDeviceCreate中创建此对象。

[in] Request

表示请求的框架请求对象的句柄。

[in] Params

指向描述配置选项的 UDECX_ENDPOINTS_CONFIGURE_PARAMS 结构的指针。

返回值

没有

言论

客户端驱动程序在上一次调用中注册了此回调函数,UdecxUsbDeviceInitSetStateChangeCallbacks,方法是提供指向其实现的函数指针。

类扩展调用此回调函数以请求客户端驱动程序将一个或多个新终结点配置为硬件,/或通知驱动程序何时不再使用一个或多个现有终结点。

创建终结点后,对于每个新终结点,客户端驱动程序必须在完成请求之前调用 UdecxUsbEndpointSetWdfIoQueue

释放终结点后,客户端驱动程序不应使用与终结点关联的框架队列对象。 类扩展将这些队列视为清除,以防止将来的请求。

类扩展还可以通过此回调请求新的配置值或备用设置。

此调用是异步的。 客户端驱动程序必须通过完成类扩展传递的请求,以状态发出完成信号。

要求

要求 价值
最低支持的客户端 Windows 10
支持的最低服务器 Windows Server 2016
目标平台 窗户
最低 KMDF 版本 1.15
标头 udecxusbdevice.h (包括 Udecx.h)
IRQL <=DISPATCH_LEVEL

另请参阅

体系结构:USB 设备仿真(UDE)

UdecxUsbEndpointSetWdfIoQueue

编写 UDE 客户端驱动程序