WDF驱动-中断处理(二)

2024-06-21 07:12
文章标签 wdf 中断 驱动 处理

本文主要是介绍WDF驱动-中断处理(二)，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

被动级别的中断是WDF比较有特色的地方之一，在windows下，则可以分为DIRQL、DISPATCH、PASSIVE三级处理，这三级处理是为了避免系统长时间处于高优先级下，其中PASSIVE也被成为被动级别的中断。

从框架版本 1.11 开始，Kernel-Mode Driver Framework (KMDF) 和 User-Mode Driver Framework (在操作系统的 Windows 8 或更高版本上运行的 UMDF) 驱动程序可以创建需要被动级别处理的中断对象。 如果驱动程序为被动级别中断处理配置了中断对象，则框架在持有被动级别中断锁时调用驱动程序的中断服务例程 (ISR) 和其他 中断对象事件回调函数，此时IRQL = PASSIVE_LEVEL。

如果要为芯片上的系统开发基于框架的驱动程序 (SoC) 平台，则可以使用被动模式中断通过低速总线（如 I²C、SPI 或 UART）与 SoC 外部设备通信。

否则，应使用 需要在设备的 IRQL (DIRQL) 进行处理的中断。 如果驱动程序支持消息信号中断 (MSI) ，则必须使用 DIRQL 中断处理。 在版本 1.9 及更早版本中，框架始终在 IRQL = DIRQL 处处理中断。

创建Passive-Level中断

若要创建被动级别中断对象，驱动程序必须初始化 WDF_INTERRUPT_CONFIG 结构并将其传递给 WdfInterruptCreate 方法。 在配置结构中，驱动程序应：

  • 将 PassiveHandling 成员设置为 TRUE；
  • 提供在被动级别调用的 EvtInterruptIsr 回调函数；
  • （可选）将 AutomaticSerialization 设置为 TRUE。 如果驱动程序将 AutomaticSerialization 设置为 TRUE，则框架会将中断对象的 EvtInterruptDpc 或 EvtInterruptWorkItem 回调函数的执行与来自中断父对象下的其他对象的回调函数同步；
  • （可选）驱动程序可以提供 EvtInterruptWorkItem 回调函数（将在 IRQL = PASSIVE_LEVEL 调用）或 EvtInterruptDpc 回调函数，以在 IRQL = DISPATCH_LEVEL调用；
维护Passive-Level中断

EvtInterruptIsr 回调函数在 IRQL = PASSIVE_LEVEL运行，并保留被动级别中断锁，通常计划中断工作项或中断 DPC 以在以后处理与中断相关的信息。 基于框架的驱动程序将工作项或 DPC 例程实现为 EvtInterruptWorkItem 或 EvtInterruptDpc 回调函数。

若要计划执行 EvtInterruptWorkItem 回调函数，驱动程序会从 EvtInterruptIsr 回调函数中调用 WdfInterruptQueueWorkItemForIsr。

若要计划执行 EvtInterruptDpc 回调函数，驱动程序会从 EvtInterruptIsr 回调函数中调用 WdfInterruptQueueDpcForIsr。 (回想一下，驱动程序的 EvtInterruptIsr 回调函数可以调用 WdfInterruptQueueWorkItemForIsr 或 WdfInterruptQueueDpcForIsr，但不能同时调用两者。)

大多数驱动程序对每种中断类型使用单个 EvtInterruptWorkItem 或 EvtInterruptDpc 回调函数。 如果驱动程序为每个设备创建多个框架中断对象，请考虑为每个中断使用单独的 EvtInterruptWorkItem 或 EvtInterruptDpc 回调。

驱动程序通常在其 EvtInterruptWorkItem 或 EvtInterruptDpc 回调函数中完成 I/O 请求。

下面的代码示例演示了使用被动级别中断的驱动程序如何从其 EvtInterruptIsr 函数中计划 EvtInterruptWorkItem 回调。

BOOLEANEvtInterruptIsr(_In_  WDFINTERRUPT Interrupt,_In_  ULONG        MessageID)
/*++Routine Description:This routine responds to interrupts generated by the hardware.It stops the interrupt and schedules a work item for additional processing.This ISR is called at PASSIVE_LEVEL (passive-level interrupt handling).Arguments:Interrupt - a handle to a framework interrupt objectMessageID - message number identifying the device'shardware interrupt message (if using MSI)Return Value:TRUE if interrupt recognized.--*/
{UNREFERENCED_PARAMETER(MessageID);NTSTATUS                status;PDEV_CONTEXT            devCtx;WDFREQUEST              request;WDF_MEMORY_DESCRIPTOR   memoryDescriptor;INT_REPORT              intReport = {0};BOOLEAN                 intRecognized;WDFIOTARGET             ioTarget;ULONG_PTR               bytes;WDFMEMORY               reqMemory;intRecognized = FALSE;//         // Typically the pattern in most ISRs (DIRQL or otherwise) is to:// a) Check if the interrupt belongs to this device (shared interrupts).// b) Stop the interrupt if the interrupt belongs to this device.// c) Acknowledge the interrupt if the interrupt belongs to this device.////// Retrieve device context so that we can access our queues later.//    devCtx = GetDevContext(WdfInterruptGetDevice(Interrupt));//// Init memory descriptor.//    WDF_MEMORY_DESCRIPTOR_INIT_BUFFER(&memoryDescriptor,&intReport,sizeof(intReport);//// Send read registers/data IOCTL. // This call stops the interrupt and reads the data at the same time.// The device will reinterrupt when a new read is sent.//bytes = 0;status = WdfIoTargetSendIoctlSynchronously(ioTarget,NULL,IOCTL_READ_REPORT,&memoryDescriptor,NULL,NULL,&bytes);//// Return from ISR if this is not our interrupt.// if (intReport->Interrupt == FALSE) {goto exit;}intRecognized = TRUE;//// Validate the data received.//...//// Retrieve the next read request from the ReportQueue which// stores all the incoming IOCTL_READ_REPORT requests// request = NULL;status = WdfIoQueueRetrieveNextRequest(devCtx->ReportQueue,&request);if (!NT_SUCCESS(status) || (request == NULL)) {//// No requests to process. //goto exit;}//// Retrieve the request buffer.//status = WdfRequestRetrieveOutputMemory(request, &reqMemory);//// Copy the data read into the request buffer.// The request will be completed in the work item.//bytes = intReport->Data->Length;status = WdfMemoryCopyFromBuffer(reqMemory,0,intReport->Data,bytes);//// Report how many bytes were copied.//WdfRequestSetInformation(request, bytes);//// Forward the request to the completion queue.//status = WdfRequestForwardToIoQueue(request, devCtx->CompletionQueue);//// Queue a work-item to complete the request.//WdfInterruptQueueWorkItemForIsr(FxInterrupt);exit:return intRecognized;
}VOID
EvtInterruptWorkItem(_In_ WDFINTERRUPT   Interrupt,_In_ WDFOBJECT      Device)
/*++Routine Description:This work item handler is triggered by the interrupt ISR.Arguments:WorkItem - framework work item objectReturn Value:None--*/
{UNREFERENCED_PARAMETER(Device);WDFREQUEST              request;NTSTATUS                status;PDEV_CONTEXT            devCtx;BOOLEAN                 run, rerun;devCtx = GetDevContext(WdfInterruptGetDevice(Interrupt));WdfSpinLockAcquire(devCtx->WorkItemSpinLock);if (devCtx->WorkItemInProgress) {devCtx->WorkItemRerun = TRUE;run = FALSE;}else {devCtx->WorkItemInProgress = TRUE;devCtx->WorkItemRerun = FALSE;run = TRUE;}WdfSpinLockRelease(devCtx->WorkItemSpinLock);if (run == FALSE) {return;}do {  for (;;) {//// Complete all report requests in the completion queue.//request = NULL;status = WdfIoQueueRetrieveNextRequest(devCtx->CompletionQueue, &request);if (!NT_SUCCESS(status) || (request == NULL)) {break;}WdfRequestComplete(request, STATUS_SUCCESS);}WdfSpinLockAcquire(devCtx->WorkItemSpinLock);if (devCtx->WorkItemRerun) {rerun = TRUE;devCtx->WorkItemRerun = FALSE;}else {devCtx->WorkItemInProgress = FALSE;rerun = FALSE;}WdfSpinLockRelease(devCtx->WorkItemSpinLock);}while (rerun);
}VOID
EvtIoInternalDeviceControl(_In_  WDFQUEUE      Queue,_In_  WDFREQUEST    Request,_In_  size_t        OutputBufferLength,_In_  size_t        InputBufferLength,_In_  ULONG         IoControlCode)
{NTSTATUS            status;DEVICE_CONTEXT      devCtx;devCtx = GetDeviceContext(WdfIoQueueGetDevice(Queue));switch (IoControlCode) {...case IOCTL_READ_REPORT://// Forward the request to the manual ReportQueue to be completed// later by the interrupt work item.//status = WdfRequestForwardToIoQueue(Request, devCtx->ReportQueue);break;...}if (!NT_SUCCESS(status)) {WdfRequestComplete(Request, status);}
}
同步Passive-Level中断

若要防止死锁，请在编写实现被动级别中断处理的驱动程序时遵循以下准则：

  • 如果 AutomaticSerialization 设置为 TRUE，请不要在 EvtInterruptDpc 或 EvtInterruptWorkItem 回调函数中发送同步请求；
  • 在 完成 I/O 请求之前释放被动级别中断锁；
  • 根据需要提供 EvtInterruptDisable、 EvtInterruptEnable 和 EvtInterruptWorkItem ；
  • 如果驱动程序必须在任意线程上下文（例如 请求处理程序）中执行与中断相关的工作，请使用 WdfInterruptTryToAcquireLock 和 WdfInterruptReleaseLock。 不要从任意线程上下文调用 WdfInterruptAcquireLock、 WdfInterruptSynchronize、 WdfInterruptEnable 或 WdfInterruptDisable 。 如果调用 WdfInterruptTryToAcquireLock 失败，驱动程序可以将与中断相关的工作推迟到工作项。 在该工作项中，驱动程序可以通过调用 WdfInterruptAcquireLock 安全地获取中断锁。 在非任意线程上下文（如工作项）中，驱动程序可以调用 WdfInterruptAcquireLock 或 WdfInterruptSynchronize；

这篇关于WDF驱动-中断处理(二)的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1080543。

相关文章

百度OCR识别结构结构化处理视频

百度OCR识别结构结构化处理视频

https://edu.csdn.net/course/detail/10506
阅读更多...
如何在Java中处理JSON数据？

如何在Java中处理JSON数据？

如何在Java中处理JSON数据？ 大家好，我是免费搭建查券返利机器人省钱赚佣金就用微赚淘客系统3.0的小编，也是冬天不穿秋裤，天冷也要风度的程序猿！今天我们将探讨在Java中如何处理JSON数据。JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，在现代应用程序中被广泛使用。Java通过多种库和API提供了处理JSON的能力，我们将深入了解其用法和最佳
阅读更多...
AI学习指南机器学习篇-朴素贝叶斯处理连续特征和离散特征

AI学习指南机器学习篇-朴素贝叶斯处理连续特征和离散特征

AI学习指南机器学习篇-朴素贝叶斯处理连续特征和离散特征 在机器学习领域，朴素贝叶斯是一种常用的分类算法，它的简单性和高效性使得它在实际应用中得到了广泛的应用。然而，在使用朴素贝叶斯算法进行分类时，我们通常会面临一个重要的问题，就是如何处理连续特征和离散特征。因为朴素贝叶斯算法基于特征的条件独立性假设，所以对于不同类型的特征，我们需要采取不同的处理方式。 在本篇博客中，我们将探讨如何有效地处理
阅读更多...
WDF驱动开发-WDF总线枚举(一)

WDF驱动开发-WDF总线枚举(一)

支持在总线驱动程序中进行 PnP 和电源管理 某些设备永久插入系统，而其他设备可以在系统运行时插入和拔出电源。 总线驱动 必须识别并报告连接到其总线的设备，并且他们必须发现并报告系统中设备的到达和离开情况。 总线驱动程序标识和报告的设备称为总线的 子设备。 标识和报告子设备的过程称为 总线枚举。 在总线枚举期间，总线驱动程序会为其子 设备创建设备对象 。  总线驱动程序本质上是同时处理总线枚
阅读更多...
神经网络第四篇：推理处理之手写数字识别

神经网络第四篇：推理处理之手写数字识别

到目前为止，我们已经介绍完了神经网络的基本结构，现在用一个图像识别示例对前面的知识作整体的总结。本专题知识点如下： MNIST数据集图像数据转图像神经网络的推理处理批处理  MNIST数据集          mnist数据图像 MNIST数据集由0到9的数字图像构成。像素取值在0到255之间。每个图像数据都相应地标有“7”、“2”、“1”等数字标签。MNIST数据集中，
阅读更多...
vue怎么处理跨域

vue怎么处理跨域

Vue.js 本身并不直接解决跨域问题，因为跨域问题主要是浏览器基于同源策略（Same-origin policy）的一种安全限制。然而，在Vue.js项目中，我们可以采取一些策略来绕过或处理跨域问题。 解决跨域问题的常用方法： 代理服务器：在开发环境中，我们可以配置一个代理服务器来转发API请求，从而绕过浏览器的同源策略。Vue CLI 提供了内置的代理功能，可以在 vue.config.j
阅读更多...
【机器学习】自然语言处理的新前沿：GPT-4与Beyond

【机器学习】自然语言处理的新前沿：GPT-4与Beyond

📝个人主页：哈__ 期待您的关注  目录 🔥引言 背景介绍 文章目的 一、GPT-4简介 GPT-4概述 主要特性 局限性和挑战 二、自监督学习的新进展 自监督学习的原理 代表性模型和技术 三、少样本学习和零样本学习 少样本学习的挑战 先进方法 四、跨模态学习 跨模态学习的概念 代表性技术 应用场景 第五部分：可解释性和透明性 AI的可解释
阅读更多...
【文末附gpt升级秘笈】腾讯元宝AI搜索解析能力升级：千万字超长文处理的新里程碑

【文末附gpt升级秘笈】腾讯元宝AI搜索解析能力升级：千万字超长文处理的新里程碑

腾讯元宝AI搜索解析能力升级：千万字超长文处理的新里程碑 一、引言 随着人工智能技术的飞速发展，自然语言处理（NLP）和机器学习（ML）在各行各业的应用日益广泛。其中，AI搜索解析能力作为信息检索和知识抽取的核心技术，受到了广泛的关注和研究。腾讯作为互联网行业的领军企业，其在AI领域的探索和创新一直走在前列。近日，腾讯旗下的AI大模型应用——腾讯元宝，迎来了1.1.7版本的升级，新版本在AI搜
阅读更多...
AndroidStudio打包处理

AndroidStudio打包处理

AndroidStudio非常强大，公司最近有一个需求是要实现对一个APP进行多个版本的打包，而且可以同时安装在手机上。这个需求详细一点的描述是：公司有一个APP，有多个开发商要使用我们的APP，为了大家都想有一个自己的APP，而且图标不一样，app名字不一样，背景不一样等。我查询了一下资料发现，在AndroidStudio的gradle是可以配置的。在此特意写一篇文章记录分享。 配置签名 首
阅读更多...
WDF驱动开发-特定于KMDF的技术(一)

WDF驱动开发-特定于KMDF的技术(一)

这部分的技术是一些零散的记录知识点，它们主要是在WDF框架中特定于KMDF的部分。 将内核模式驱动程序框架和非 PnP 驱动程序配合使用 如果要为不支持 即插即用 (PnP) 的设备编写驱动程序，则驱动程序必须： 在 WDF_DRIVER_CONFIG 结构的 DriverInitFlags 成员中设置 WdfDriverInitNonPnpDriver 标志；提供 EvtDriverUnl
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2