通过

UdecxWdfDeviceTryHandleUserIoctl 函数 （udecxwdfdevice.h）

  • 项目

尝试处理用户模式软件发送的 IOCTL 请求。

语法

BOOLEAN UdecxWdfDeviceTryHandleUserIoctl(
       WDFDEVICE  UdecxWdfDevice,
  [in] WDFREQUEST Request
);

参数

UdecxWdfDevice

表示控制器的框架设备对象的句柄。 客户端驱动程序在上一次调用 UdecxWdfDeviceAddUsbDeviceEmulation中初始化了此对象。

[in] Request

表示 IOCTL 请求的框架请求对象的句柄。

返回值

TRUE 表示 USB 设备仿真类扩展 （UdeCx） 已识别并完成请求（成功或失败）。 在这种情况下，客户端驱动程序不能完成请求。 否则为 FALSE;驱动程序必须完成请求。

言论

UDE 客户端驱动程序以主机控制器驱动程序的形式呈现给用户模式软件。 客户端驱动程序注册并公开GUID_DEVINTERFACE_USB_HOST_CONTROLLER设备接口 GUID。 用户模式软件可以通过指定 GUID 来打开设备的句柄。 通过使用该句柄，软件可以发送 IOCTL 请求。

注意 请注意，其他接口的 IOCTL 代码可能与 USB 主机控制器接口重叠。 如果此类 I/O 达到此函数，则无法正确处理 IOCTL。
 
客户端驱动程序不需要处理收到的 IOCTL。 它可以通过调用 UdecxWdfDeviceTryHandleUserIoctl将请求发送到类扩展。 如果类扩展将请求识别为标准请求，则会完成该请求。 否则，调用将失败，然后客户端驱动程序应完成请求。 有关必须处理的 IOCTL 列表，请参阅 应用程序和服务的 USB IOCTL。

要求

要求 价值
最低支持的客户端 Windows 10
支持的最低服务器 Windows Server 2016
目标平台 窗户
最低 KMDF 版本 1.15
标头 udecxwdfdevice.h （包括 Udecx.h）
库 Udecxstub.lib
IRQL PASSIVE_LEVEL

另请参阅

体系结构：USB 设备仿真（UDE）

编写 UDE 客户端驱动程序