使用控制设备对象

控制设备对象是不支持即插即用 (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) 创建物理设备对象。 驱动程序为每个设备调用 WdfPdoInitAssignRawDevice 和 WdfDeviceInitAssignName ，应用程序可以在发送自定义 I/O 控件代码时按名称标识设备。)

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

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

创建控制设备对象

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

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

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

   • WdfControlDeviceInitSetShutdownNotification
   • WdfDeviceInitAssignName
   • WdfDeviceInitAssignSDDLString
   • WdfDeviceInitAssignWdmIrpPreprocessCallback
   • WdfDeviceInitSetCharacteristics
   • WdfDeviceInitSetDeviceClass
   • WdfDeviceInitSetExclusive
   • WdfDeviceInitSetFileObjectConfig
   • WdfDeviceInitSetIoInCallerContextCallback
   • WdfDeviceInitSetIoType
   • WdfDeviceInitSetRequestAttributes

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

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

   • 如果需要，请为设备创建默认 I/O 队列。
   • 如果需要，请调用 WdfDeviceConfigureRequestDispatching。
   • 调用 WdfDeviceCreateSymbolicLink 以创建应用程序可用于访问控制设备的符号链接名称。

5. 调用 WdfControlFinishInitializing。

使用控制设备对象的规则

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

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

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

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

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

命名控件设备对象

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

如果驱动程序未调用 WdfDeviceInitAssignName 来分配设备名称，框架会自动为控制设备生成名称，但驱动程序无法调用 WdfDeviceCreateSymbolicLink。

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

接收系统关闭通知

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

删除控制设备对象

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

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

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

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

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

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