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

另请参阅

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

编写 UDE 客户端驱动程序