框架设备对象

警告

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 方法通知驱动程序到达,并在调用中传递 IWDFDriverIWDFDeviceInitialize 接口。 驱动程序可以调用 IWDFDeviceInitialize 接口的方法来初始化新设备。 例如,驱动程序调用 IWDFDeviceInitialize::RetrieveDevicePropertyStore 方法来查询作为设备安装的一部分提供的设备信息。 然后,驱动程序可以调用 IWDFDriver::CreateDevice 方法来配置和创建设备对象。

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