使用控制设备对象

控制设备对象是不支持 即插即用 (PnP) 或电源管理操作的框架设备对象。 驱动程序可以使用控制设备对象来表示仅限软件的虚拟设备或 旧硬件设备 (,即不提供 PnP 或电源管理功能的设备) 。

创建控件设备对象的驱动程序通常还会为设备对象创建符号链接。 应用程序可以通过将符号链接名称传递给 API 元素(如 Microsoft Win32 CreateFile 函数)将 I/O 请求发送到控制设备对象。

框架不会将控制设备对象附加到 设备堆栈。 因此,当应用程序向控制设备对象发送 I/O 请求时,I/O 管理器会将请求直接传递到创建控制设备对象的驱动程序,而不是发送到堆栈顶部的驱动程序。 但是, (,其他驱动程序可以调用 IoAttachDevice 来附加控制设备对象上方的设备对象。在这种情况下,其他驱动程序先接收 I/O 请求。)

控制设备对象的用法

控制设备的两个典型用途包括:

  1. 如果驱动程序支持一组自定义 I/O 控制代码供应用程序使用,则为 PnP 设备提供筛选器驱动程序。

    例如,如果应用程序尝试通过使用设备 接口 的符号链接名称 () 将自定义 I/O 控制代码发送到驱动程序堆栈顶部,则筛选器驱动程序上方的驱动程序可能无法识别自定义 I/O 控件代码,则筛选器驱动程序上方的驱动程序可能会失败 I/O 请求。 为了避免此问题,筛选器驱动程序可以创建控制设备对象。 应用程序可以使用控件设备对象的符号链接名称将 I/O 控制代码直接发送到筛选器驱动程序。

    (请注意,筛选器驱动程序避免此问题的更好方法是充当总线驱动程序并 枚举 在原始模式下运行的子设备。 换句话说,对于筛选器驱动程序支持的每个设备,驱动程序可以创建不需要函数驱动程序的物理设备对象 (PDO) 。 驱动程序为每个设备调用 WdfPdoInitAssignRawDeviceWdfDeviceInitAssignName ,应用程序在发送自定义 I/O 控制代码时可以按名称标识设备 ) 。

  2. 不支持 PnP 的设备驱动程序。

    此类驱动程序必须使用控制设备对象,因为此类设备的设备对象不驻留在设备堆栈中,并且不提供 PnP 功能。 有关支持非 PnP 设备的详细信息,请参阅 将 Kernel-Mode Driver Framework 与非 PnP 驱动程序配合使用

创建控件设备对象

若要创建控制设备对象,驱动程序必须:

  1. 调用 WdfControlDeviceInitAllocate 以获取 WDFDEVICE_INIT 结构。

  2. 根据需要调用对象初始化方法以初始化WDFDEVICE_INIT结构。 驱动程序只能调用以下初始化方法:

  3. 调用 WdfDeviceCreate,它使用WDFDEVICE_INIT结构的内容来创建框架设备对象。

  4. 完成以下初始化操作:

  5. 调用 WdfControlFinishInitializing

使用控制设备对象的规则

创建控制设备对象的驱动程序必须遵循以下规则:

  • 驱动程序无法将控制设备对象的句柄传递给 枚举子设备的框架方法。

  • 驱动程序无法将控制设备对象的句柄传递给支持 设备接口的框架方法。

  • 驱动程序可以为队列创建 I/O 队列并注册请求处理程序,但框架不允许对队列进行 电源管理

  • 驱动程序可以为控制设备 对象创建文件对象

命名控件设备对象

所有控制设备对象都必须命名。 通常,驱动程序将调用 WdfDeviceInitAssignName 来分配设备名称,然后调用 WdfDeviceCreateSymbolicLink 来创建应用程序可用于访问对象的符号链接名称。

如果驱动程序不调用 WdfDeviceInitAssignName 来分配设备名称,则框架会自动生成控制设备的名称,但驱动程序无法调用 WdfDeviceCreateSymbolicLink

驱动程序可以调用 WdfDeviceInitSetDeviceClass ,为控制设备指定 设备设置类 。 设备安装类标识注册表的一部分,其中包含有关属于安装类的设备的管理员提供的信息。 有关调用 WdfDeviceInitSetDeviceClass 的详细信息,请参阅 Framework-Based驱动程序中的控制设备访问

接收系统关闭通知

由于控制设备对象不支持 PnP,因此驱动程序无法注册回调函数,当设备电源状态发生更改时通知驱动程序。 但是,驱动程序可以调用 WdfControlDeviceInitSetShutdownNotification 来注册 EvtDeviceShutdownNotification 回调函数。 当系统即将失去电源时,此回调函数会通知驱动程序。

删除控件设备对象

某些驱动程序在卸载驱动程序之前必须删除其控制设备对象,如下所示:

  • 如果驱动程序创建控制设备对象 (不支持 PnP 或电源管理) ,并且驱动程序还创建支持 PnP 和电源管理的框架设备对象,驱动程序最终必须在 IRQL = PASSIVE_LEVEL 调用 WdfObjectDelete 以删除控制设备对象。

    如果驱动程序创建这两种类型的设备对象,则在驱动程序删除控制设备对象之前,操作系统无法卸载驱动程序。

    但是,在框架删除其他设备对象之后,驱动程序不得删除控制设备对象。 若要确定框架何时删除了其他设备对象,驱动程序应为这些对象提供 EvtCleanupCallback 函数。

  • 如果驱动程序创建控制设备对象,但不创建支持 PnP 和电源管理的框架设备对象,则驱动程序不必删除控制设备对象。

    在这种情况下,框架在驱动程序的 EvtDriverUnload 回调函数返回后删除控制设备对象。