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
目标平台 Windows
最低 KMDF 版本 1.15
标头 udecxwdfdevice.h (包括 Udecx.h)
Library Udecxstub.lib
IRQL PASSIVE_LEVEL

另请参阅

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

编写 UDE 客户端驱动程序