UdecxWdfDeviceAddUsbDeviceEmulation 函数 (udecxwdfdevice.h)
初始化框架设备对象,以支持与主机控制器和连接到控制器的虚拟 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 错误代码。
注解
模拟主机控制器和 USB 设备的 UDE 客户端驱动程序必须在 WdfDeviceCreate 调用后调用此方法。
在此调用期间,还会注册客户端驱动程序提供的事件回调实现。 通过调用设置UDECX_WDF_DEVICE_CONFIG的适当成员,提供指向这些函数的 函数指针。
方法使框架设备对象能够执行与控制器及其根集线器相关的操作,例如处理处理发送到附加 USB 设备的 IOCTL 请求所需的各种队列。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 |
最低受支持的服务器 | Windows Server 2016 |
目标平台 | Windows |
最低 KMDF 版本 | 1.15 |
标头 | udecxwdfdevice.h (包括 Udecx.h) |
Library | Udecxstub.lib |
IRQL | PASSIVE_LEVEL |