WDF驱动开发-PNP和电源管理

对于PNP驱动设备,我们需要理解它们的启动和删除顺序,以及意外拔出顺序。在开始之前我们先了解下电源状态的定义:

系统电源状态:

S0-PowerSystemWorking

S1-PowerSystemSleepingl

S2-PowerSystemSleeping2

S3-PowerSystemSleeping3

S4-PowerSystemHibernate

S5-PowerSystemShutdown

其中S0是工作态,S5是关机状态,状态S1、S2、S3、S4是休眠态,能源消耗量依次递减。

注意:系统不能从一种休眠状态直接进入另一种休眠状态,它必须在进入另一种休眠状态 之前先进入工作状态。例如,系统不能从状态S1转变到状态S2,也不能从状态S2转 变到状态S1:它必须首先回到工作状态S0,然后才能再进入下一个休眠状态。因为处 于一种中间休眠状态的系统已经失去某种操作环境,在进行其他状态转变之前,它必须 回到工作状态SO以恢复该环境。

设备电源状态:

D0-PowerDeviceD0

Dl-PowerDeviceDl

D2-PowerDeviceD2

D3-PowerDeviceD3

其中D0是工作态, 状态D1、D2是休眠态,D3是关闭状态。

注意:设备能从工作状态D0转变到任一种休眠状态(D1或D2),也能从任一种休眠状态转变到工作状态。设备还能从一种休眠状态直接进入另一种休眠状态。

(1)、 FDO or filter DO 驱动程序的启动顺序

下图显示了框架调用 WDF (KMDF 和 UMDF V2) 功能或Filter驱动程序的事件回调函数的顺序,从图底部的"设备插入"状态开始(宽横线标记启动设备所涉及的步骤。 图左侧的列描述了步骤,右侧的列列出了完成该步骤的事件回调)。

在图的底部,系统不存在该设备。 当用户插入设备时,框架首先调用驱动程序的 EvtDriverDeviceAdd 回调,以便驱动程序可以创建设备对象来表示设备。 框架继续调用驱动程序的回调例程,方法是继续执行序列,直到设备正常运行。 请记住,框架按自下而上的顺序调用事件回调,如图所示,因此 在 EvtDeviceFilterAddResourceRequirements 等之前调用 EvtDeviceFilterRemoveResourceRequirements 。 如果设备已停止以重新平衡资源或实际存在但处于低功耗状态,则并非所有步骤都是必需的,如下面的总线驱动程序的启动顺序图所示。

(2)、 总线驱动程序的启动顺序

下图显示了从图底部的"设备插入"状态所示,使设备进入完全运行状态时,框架调用 KMDF 总线驱动程序的事件回调函数的顺序:

在从系统中物理删除相应的设备之前,框架不会以物理方式删除 PDO。 例如,如果用户在 设备管理器 中禁用了设备,但没有实际删除该设备,则框架会保留其设备对象。 因此,图底部的三个步骤仅在即插即用枚举期间发生,即在初始启动期间或用户插入新设备时。 如果设备以前已禁用但未实际删除,框架会通过调用 EvtDevicePrepareHardware 回调启动。

(3)、FDO or filter DO 驱动程序的电源关闭和删除顺序

下图显示了关闭和删除设备时框架调用 KMDF 功能或Filter驱动程序的事件回调函数的顺序。 序列从图的顶部开始,设备处于工作电源状态 (D0) :

如图所示,KMDF 关机和删除序列涉及按框架调用使设备正常运行所涉及的函数的相反顺序调用相应的"撤消"回调。 框架在删除设备对象上下文区域后删除设备对象。

(4)、总线驱动程序的电源关闭和删除顺序

下图显示了在关闭并删除连接到总线的设备时框架调用 KMDF 总线驱动程序的事件回调函数的顺序。 序列从图的顶部开始,设备处于工作电源状态 (D0) :

在从系统物理删除设备之前,框架不会删除 PDO。 例如,如果用户在 设备管理器 中禁用设备或在"安全删除硬件"实用工具中将其停止,但未以物理方式删除设备,则框架将保留 PDO。 如果设备稍后重新启用,框架将使用相同的 PDO,并通过调用 EvtDevicePrepareHardware 回调来开始启动序列,如 物理设备对象的电源启动序列中所示。

注意:通常,框架在为驱动程序枚举的所有子设备调用 EvtDeviceReleaseHardware 函数后,会调用总线驱动程序的 EvtDeviceReleaseHardware 回调函数。 如果父级遇到设备开机或关机故障,框架可能会在调用所有子设备的 EvtDeviceReleaseHardware 函数之前调用驱动程序的 EvtDeviceReleaseHardware 。 请考虑调用 WdfDeviceInitSetReleaseHardwareOrderOnFailure ,以确保框架仅在删除所有子设备后调用总线驱动程序的 EvtDeviceReleaseHardware 回调。

(5)、意外删除顺序

如果用户在不发出警告的情况下移除设备,只需在不使用 设备管理器 或安全删除硬件实用工具的情况下拔下设备,则设备被视为"意外删除"。发生这种情况时,框架遵循略有不同的删除顺序。 如果另一个驱动程序在设备上调用 IoInvalidateDeviceState ,则也会遵循意外删除序列,即使设备在物理上仍然存在。 在意外删除序列中,框架先调用 EvtDeviceSurpriseRemoval 回调,然后再调用删除序列中的其他任何回调。 序列完成后,框架将销毁设备对象。 所有可移动设备的驱动程序必须确保关闭和启动路径中的回调可以处理故障,尤其是硬件删除导致的故障。 访问硬件的任何尝试都不应无限期等待,但应受到超时或监视程序计时器的约束。

下图显示了意外删除中涉及的回调:

如果设备在删除时未处于工作状态,框架会在 EvtDeviceSurpriseRemoval 之后立即调用 EvtDeviceReleaseHardware 事件回调。 它省略了在设备退出工作状态时已执行的干预步骤。

处理停止设备的请求

在两种情况下,在要求设备的驱动程序停止设备之前,PnP 管理器会询问驱动程序是否是一个好主意:

用户已插入新设备,PnP 管理器必须 重新分发系统的硬件资源 以适应新设备;

用户已指示他/她要 删除该设备;

驱动程序可以通过多种方式处理这些情况:

如果驱动程序由于设备支持特殊文件而调用了 WdfDeviceSetSpecialFileSupport ,并且如果设备上打开了特殊文件,则框架将不允许设备停止;

若要在相对较短的时间内暂时阻止所有停止,驱动程序可以调用 WdfDeviceSetStaticStopRemove;

若要单独评估和处理每个停止尝试,驱动程序可以提供 EvtDeviceQueryStop 和 EvtDeviceQueryRemove 回调函数;

如果设备不支持特殊文件,并且停止或删除设备绝不是驱动程序或设备的问题,则驱动程序不提供 EvtDeviceQueryStop 和 EvtDeviceQueryRemove 回调函数,并且从不调用 WdfDeviceSetStaticStopRemove。 在这种情况下,PnP 管理器始终停止设备,而无需先检查驱动程序是否允许它。

重新分发资源

有时,PnP 管理器必须重新分发系统的硬件资源。 通常,发生此重新分发是因为总线驱动程序已报告已插入新设备,并且新设备需要已分配的资源。 在重新分配资源之前,必须停止设备。

如果驱动程序有时需要阻止 PnP 管理器停止繁忙的设备,驱动程序可以提供 EvtDeviceQueryStop 回调函数。 如果驱动程序的 EvtDeviceQueryStop 回调函数返回错误状态值,则 PnP 管理器不会停止设备。

如果驱动程序确定停止设备是安全的,则回调函数将返回STATUS_SUCCESS。 如果设备的其他驱动程序都无法阻止停止,PnP 管理器将暂时停止设备。

用户删除或禁用设备

用户可以删除或禁用某些设备。 例如:

如果驱动程序已设置可移动成员 (而不是设备WDF_DEVICE_PNP_CAPABILITIES结构的 SurpriseRemovalOK 成员) ,则用户可以运行拔出或弹出硬件程序,然后拔出或弹出设备;

如果驱动程序尚未设置设备的WDF_DEVICE_STATE结构的 NotDisable 成员,则用户可以使用 设备管理器 禁用设备;

在这种情况下,PnP 管理器会尝试在用户删除设备之前将其停止。

如果驱动程序有时需要阻止删除繁忙设备,驱动程序可以提供 EvtDeviceQueryRemove 回调函数。 如果任何驱动程序的 EvtDeviceQueryRemove 回调函数返回错误状态值,则 PnP 管理器不会停止设备。

如果驱动程序确定用户删除设备是安全的,则回调函数将返回STATUS_SUCCESS。 如果设备的其他驱动程序都无法阻止删除,PnP 管理器将停止设备。

相关推荐
sukalot8 小时前
windows显示驱动开发-节能与 VSync 控制
驱动开发
tt5555555555551 天前
嵌入式开发面试八股文详解教程
linux·c++·驱动开发·面试
sukalot2 天前
windows显示驱动开发-调试间接显示驱动程序(二)
驱动开发
tt5555555555553 天前
Linux启动流程与字符设备驱动详解 - 从bootloader到驱动开发
linux·运维·驱动开发
tt5555555555554 天前
Linux 驱动开发入门:LCD 驱动与内核机制详解
linux·运维·驱动开发
tt5555555555554 天前
Linux驱动开发核心概念详解 - 从入门到精通
linux·运维·驱动开发
sukalot5 天前
windows显示驱动开发-IddCx 1.10 及更高版本的更新
windows·驱动开发
sukalot5 天前
windows显示驱动开发-调试间接显示驱动程序(三)
windows·驱动开发
sukalot5 天前
windows显示驱动开发-间接显示驱动程序
驱动开发