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 管理器将停止设备。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:/a/695589.html

如若内容造成侵权/违法违规/事实不符,请联系我们进行投诉反馈qq邮箱809451989@qq.com,一经查实,立即删除!

相关文章

中国蚁剑 安装教程 2024年5月

2024/5/11 中国蚁剑 安装教程 一、下载中国蚁剑的加载器和核心源码(两个都要用到) github官方下载地址:https://github.com/AntSwordProject/ 参考文档:antSword/README_CN.md at master AntSwordProject/antSword GitHub 核…

用咖啡来理解springboot3的自动配置机制

大家好,这里是教授.F 目录 前提知识: 场景引入: 1.Starter依赖: 2.默认配置: 3.自定义配置: 4.条件化配置: 5.自动装配: 具体过程: 扫包路径的配置: 配置…

招聘在家抄书员?小心是骗局!!!

在家抄书员的骗局是一种常见的网络诈骗手段,旨在利用人们想要在家轻松赚钱的心理。这种骗局通常会以招聘兼职抄写员的形式出现,声称只需在家中抄写书籍即可赚取可观的收入。然而,实际上这背后隐藏着诸多陷阱和虚假承诺。 首先,这些…

生成式人工智能 - 本地windows 11 + PyCharm运行stable diffusion流程简述

一、环境说明 硬件:本地电脑windows11、32.0 GB内存、2060的6G的卡。 软件:本地有一个python环境,主要是torch 2.2.2+cu118 二、准备工作 1、下载模型 https://huggingface.co/CompVishttps://huggingface.co/CompVis 进入上面的网址,我这里下载的是这个里面的 …

二分#背包#快排#LCS详解

二分#背包#快排#LCS详解 文章目录 二分#背包#快排#LCS详解1. 二分搜索2. 01背包问题3. 快速排序4. 最长公共子序列 1. 二分搜索 在处理大规模数据集时,查找操作的效率显得尤为重要。二分搜索是一种在有序数组中查找目标值的高效算法,其时间复杂度为O(lo…

超详细 | 使用Nexus搭建私服 (带代码演示)

为什么需要搭建私有仓库? 在企业开发的过程中,不是所有公司都能直接访问外网。在这种情况下,就需要在局域网内找一台有外网访问权限的服务器,搭建Nexus私服仓库,开发人员连接到这台私服上,通过搭建的Nexus…

Golang | Leetcode Golang题解之第142题环形链表II

题目: 题解: func detectCycle(head *ListNode) *ListNode {slow, fast : head, headfor fast ! nil {slow slow.Nextif fast.Next nil {return nil}fast fast.Next.Nextif fast slow {p : headfor p ! slow {p p.Nextslow slow.Next}return p}}r…

调研管理系统的设计

管理员账户功能包括:系统首页,个人中心,管理员管理,基础数据管理,教师类型管理,课程类型管理,公告类型管理 前台账户功能包括:系统首页,个人中心,论坛&#…

OPPO高级项目经理曹帆受邀为第十三届中国PMO大会演讲嘉宾

全国PMO专业人士年度盛会 OPPO互联网服务系统内容生态中心高级互联网项目经理曹帆先生受邀为PMO评论主办的2024第十三届中国PMO大会演讲嘉宾,演讲议题为“加、减、乘、除——激活项目团队效能”。大会将于6月29-30日在北京举办,敬请关注! 议…

【数学】各种图面积公式的推导

Hello!大家好,我是学霸小羊,今天讲讲面积公式。 1.长方形 长方形是 由无数条 长度为长方形的长(或宽)的线 组成的图形,这些线有多少根,我们不知道,只需要知道他们垒成了一个由高 宽…

如何获取MySQL中表的大小?(官方校正版)

与大多数关系数据库一样,MySQL 提供了有关数据库本身的有用元数据。虽然大多数其他数据库将此信息称为 catalog, 但MySQL 官方文档INFORMATION_SCHEMA 将元数据 称为 tables。 目录 1 列出单个数据库中的单表大小 2 列出所有数据库中的所有表大小 以下…

【第14章】SpringBoot实战篇之多环境配置

文章目录 前言一、通用配置文件1. 定义2. 使用2.1 application.yml2.2 启动类 3. 测试 二、多环境配置文件1.定义1.1 application-local.yml1.2 application-dev.yml1.3 application-test.yml1.4 application-prod.yml 2.使用2.1 application.yml2.2 启动类 3.测试 三、多环境配…

【机器学习】决策树模型(个人笔记)

文章目录 多样性指标基尼杂质指数(Gini Impurity Index)熵(Entropy) 决策树的应用 源代码文件请点击此处! 多样性指标 基尼杂质指数(Gini Impurity Index) 若集合中包含 m m m 个元素和 n …

【线性代数】向量空间,子空间,向量空间的基和维数

向量空间 设V为n维向量的集合,如果V非空,且集合V对于向量的加法以及数乘两种运算封闭,那么就称集合V为向量空间 x,y是n维列向量。 x 向量组等价说明可以互相线性表示 向量组等价则生成的向量空间是一样的 子空间 例题18是三位向…

人机融合既是技术也是艺术

军事智能是将人工智能技术应用于军事领域,旨在提高军事决策、指挥控制、作战效能等方面的能力。它涉及到计算机科学、数学、统计学、神经科学等多个学科领域,需要综合运用多种技术和方法。军事智能的设计和实施需要考虑到战争的本质、军事战略、战术和组…

每位比特币人都终将成为一个国际主义者

原创 | 刘教链 周末BTC(比特币)趁势向着30日均线回归,现于69k一线悬停。7万刀以下加仓的机会窗口,和那蹉跎一生的岁月一样,过一天少一天,在每个纠结和拧巴的日子里,在软弱和彷徨的等待中&#x…

小程序 UI 风格,赏心悦目

小程序 UI 风格,赏心悦目

MySQL的group by与count(), *字段使用问题

文章目录 问题group by到底做了什么举个例子简单来说为什么select字段,count()不能和*共同使用总结 问题 这是一段摘抄自MySQL官网的文字。其大致意思是MySQL拓展了group by的使用,MySQL允许选择没有出现在group by中的字段。换句话说,标准SQ…

【数据结构(邓俊辉)学习笔记】图07——最短路径

文章目录 0. 概述1. 问题2. 最短路径2.1 最短路径树2.1.1 单调性2.1.2 歧义性2.1. 3 无环性 2.2 Dijkstra 算法2.2.1 贪心迭代2.2.2 实现2.2.3 实例2.2.4 复杂度 0. 概述 学习下最短路径和Dijistra算法 1. 问题 给定带权网络G (V, E),以及源点(source…

Java日期类Date、SimpleDateFormat 日期格式类、Calendar详细介绍

目录 一、Date类1.1 Date类简单介绍1.2 Date类的构造方法代码演示 二、SimpleDateFormat 日期格式化类2.1 SimpleDateFormat 日期格式化类简单介绍2.2 构造方法代码演示 日期格式化模板常用方法代码演示注意 三、Calendar类3.1 简单介绍3.2 创建对象代码演示 3.3 静态常量3.4 常…