初始化框架设备对象以支持与主机控制器和附加到控制器的虚拟 USB 设备相关的作。
语法
NTSTATUS UdecxWdfDeviceAddUsbDeviceEmulation(
WDFDEVICE WdfDevice,
[in] PUDECX_WDF_DEVICE_CONFIG Config
);
参数
WdfDevice
客户端驱动程序在上一次调用 WdfDeviceCreate中检索到的框架设备对象的句柄。
[in] Config
指向客户端驱动程序通过调用 UDECX_WDF_DEVICE_CONFIG_INIT初始化的 UDECX_WDF_DEVICE_CONFIG 结构的指针。
返回值
如果作成功,该方法将返回STATUS_SUCCESS。 否则,此方法可能会返回相应的 NTSTATUS 错误代码。
言论
模拟主机控制器的 UDE 客户端驱动程序和 USB 设备必须在 WdfDeviceCreate 调用后调用此方法。
在此调用期间,还会注册客户端驱动程序提供的事件回调实现。 通过调用设置 UDECX_WDF_DEVICE_CONFIG的适当成员来提供这些函数的函数指针。
该方法使框架设备对象能够执行与控制器及其根中心相关的作,例如处理发送到附加 USB 设备的 IOCTL 请求所需的各种队列。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 10 |
支持的最低服务器 | Windows Server 2016 |
目标平台 | 窗户 |
最低 KMDF 版本 | 1.15 |
标头 | udecxwdfdevice.h (包括 Udecx.h) |
库 | Udecxstub.lib |
IRQL | PASSIVE_LEVEL |