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 错误代码。

言论

模拟主机控制器的 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

另请参阅

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

编写 UDE 客户端驱动程序