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
目标平台 Windows
最低 KMDF 版本 1.15
标头 udecxusbdevice.h (包括 Udecx.h)
IRQL <=DISPATCH_LEVEL

另请参阅

体系结构：USB 设备模拟 (UDE)

UdecxUsbEndpointSetWdfIoQueue

编写 UDE 客户端驱动程序