通过

框架设备对象

  • 项目

警告

UMDF 2 是最新版本的 UMDF，取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 未向 UMDF 1 添加新功能，并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。

存档的 UMDF 1 示例可在 Windows 11 版本 22H2 - 2022 年 5 月驱动程序示例更新中找到。

有关详细信息，请参阅使用 UMDF 入门。

框架设备对象通过 IWDFDevice 接口向驱动程序公开。 框架设备对象是系统上设备的框架表示形式。 每个设备对象都有一个父驱动程序对象。

当新设备到达系统时，框架会调用 IDriverEntry：：OnDeviceAdd 方法通知驱动程序到达，并在调用中传递 IWDFDriver 和 IWDFDeviceInitialize 接口。 驱动程序可以调用 IWDFDeviceInitialize 接口的方法来初始化新设备。 例如，驱动程序调用 IWDFDeviceInitialize：：RetrieveDevicePropertyStore 方法来查询作为设备安装的一部分提供的设备信息。 然后，驱动程序可以调用 IWDFDriver：：CreateDevice 方法来配置和创建设备对象。

驱动程序创建框架设备对象时，可以注册 其 IPnpCallback、 IPnpCallbackSelfManagedIo、 IPnpCallbackHardware、 IFileCallbackCleanup 和 IFileCallbackClose 接口。 然后，当文件清理和关闭以及即插即用 (PnP) 和电源管理 (PM) 事件发生时，框架会通知驱动程序。 有关支持 PnP 和 PM 的详细信息，请参阅 基于 UMDF 的驱动程序中的 PnP 和电源管理。