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

2024-06-10 21:12
文章标签 开发 驱动 管理 电源 pnp wdf

本文主要是介绍WDF驱动开发-PNP和电源管理(三),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

对于PNP设备来说,理解它们的启动和删除顺序,以及意外移除顺序非常重要,在早期,经常有拔插U盘导致windows重启的例子,这就是意外移除带来的问题。

功能或Filter驱动程序的启动顺序

下图显示了框架调用 WDF (KMDF 和 UMDF V2) 功能或Filter驱动程序的事件回调函数的顺序,从图底部的“设备插入”状态开始:

宽横线标记启动设备所涉及的步骤。 图左侧的列描述了步骤,右侧的列列出了完成该步骤的事件回调。

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

总线驱动程序的启动顺序

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

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

功能或Filter驱动程序的电源关闭和删除顺序

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

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

总线驱动程序的电源关闭和删除顺序

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

 

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

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

意外删除顺序

如果用户在不发出警告的情况下移除设备,只需在不使用 设备管理器 或安全删除硬件实用工具的情况下拔下设备,则设备被视为“意外删除”。发生这种情况时,框架遵循略有不同的删除顺序。 如果另一个驱动程序在设备上调用 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 管理器将停止设备。

这篇关于WDF驱动开发-PNP和电源管理(三)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1049282

相关文章

Go语言开发实现查询IP信息的MCP服务器

《Go语言开发实现查询IP信息的MCP服务器》随着MCP的快速普及和广泛应用,MCP服务器也层出不穷,本文将详细介绍如何在Go语言中使用go-mcp库来开发一个查询IP信息的MCP... 目录前言mcp-ip-geo 服务器目录结构说明查询 IP 信息功能实现工具实现工具管理查询单个 IP 信息工具的实现服

usb接口驱动异常问题常用解决方案

《usb接口驱动异常问题常用解决方案》当遇到USB接口驱动异常时,可以通过多种方法来解决,其中主要就包括重装USB控制器、禁用USB选择性暂停设置、更新或安装新的主板驱动等... usb接口驱动异常怎么办,USB接口驱动异常是常见问题,通常由驱动损坏、系统更新冲突、硬件故障或电源管理设置导致。以下是常用解决

HTML5中的Microdata与历史记录管理详解

《HTML5中的Microdata与历史记录管理详解》Microdata作为HTML5新增的一个特性,它允许开发者在HTML文档中添加更多的语义信息,以便于搜索引擎和浏览器更好地理解页面内容,本文将探... 目录html5中的Mijscrodata与历史记录管理背景简介html5中的Microdata使用M

Spring 基于XML配置 bean管理 Bean-IOC的方法

《Spring基于XML配置bean管理Bean-IOC的方法》:本文主要介绍Spring基于XML配置bean管理Bean-IOC的方法,本文给大家介绍的非常详细,对大家的学习或工作具有一... 目录一. spring学习的核心内容二. 基于 XML 配置 bean1. 通过类型来获取 bean2. 通过

python uv包管理小结

《pythonuv包管理小结》uv是一个高性能的Python包管理工具,它不仅能够高效地处理包管理和依赖解析,还提供了对Python版本管理的支持,本文主要介绍了pythonuv包管理小结,具有一... 目录安装 uv使用 uv 管理 python 版本安装指定版本的 Python查看已安装的 Python

使用Python开发一个带EPUB转换功能的Markdown编辑器

《使用Python开发一个带EPUB转换功能的Markdown编辑器》Markdown因其简单易用和强大的格式支持,成为了写作者、开发者及内容创作者的首选格式,本文将通过Python开发一个Markd... 目录应用概览代码结构与核心组件1. 初始化与布局 (__init__)2. 工具栏 (setup_t

Spring Shell 命令行实现交互式Shell应用开发

《SpringShell命令行实现交互式Shell应用开发》本文主要介绍了SpringShell命令行实现交互式Shell应用开发,能够帮助开发者快速构建功能丰富的命令行应用程序,具有一定的参考价... 目录引言一、Spring Shell概述二、创建命令类三、命令参数处理四、命令分组与帮助系统五、自定义S

基于Python和MoviePy实现照片管理和视频合成工具

《基于Python和MoviePy实现照片管理和视频合成工具》在这篇博客中,我们将详细剖析一个基于Python的图形界面应用程序,该程序使用wxPython构建用户界面,并结合MoviePy、Pill... 目录引言项目概述代码结构分析1. 导入和依赖2. 主类:PhotoManager初始化方法:__in

Python通过模块化开发优化代码的技巧分享

《Python通过模块化开发优化代码的技巧分享》模块化开发就是把代码拆成一个个“零件”,该封装封装,该拆分拆分,下面小编就来和大家简单聊聊python如何用模块化开发进行代码优化吧... 目录什么是模块化开发如何拆分代码改进版:拆分成模块让模块更强大:使用 __init__.py你一定会遇到的问题模www.

Spring Security基于数据库的ABAC属性权限模型实战开发教程

《SpringSecurity基于数据库的ABAC属性权限模型实战开发教程》:本文主要介绍SpringSecurity基于数据库的ABAC属性权限模型实战开发教程,本文给大家介绍的非常详细,对大... 目录1. 前言2. 权限决策依据RBACABAC综合对比3. 数据库表结构说明4. 实战开始5. MyBA