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。

相关文章

Go语言使用Buffer实现高性能处理字节和字符

Go语言使用Buffer实现高性能处理字节和字符

《Go语言使用Buffer实现高性能处理字节和字符》在Go中,bytes.Buffer是一个非常高效的类型,用于处理字节数据的读写操作,本文将详细介绍一下如何使用Buffer实现高性能处理字节和... 目录1. bytes.Buffer 的基本用法1.1. 创建和初始化 Buffer1.2. 使用 Writ
阅读更多...
Python视频处理库VidGear使用小结

Python视频处理库VidGear使用小结

《Python视频处理库VidGear使用小结》VidGear是一个高性能的Python视频处理库,本文主要介绍了Python视频处理库VidGear使用小结,文中通过示例代码介绍的非常详细,对大家的... 目录一、VidGear的安装二、VidGear的主要功能三、VidGear的使用示例四、VidGea
阅读更多...
Python结合requests和Cheerio处理网页内容的操作步骤

Python结合requests和Cheerio处理网页内容的操作步骤

《Python结合requests和Cheerio处理网页内容的操作步骤》Python因其简洁明了的语法和强大的库支持,成为了编写爬虫程序的首选语言之一,requests库是Python中用于发送HT... 目录一、前言二、环境搭建三、requests库的基本使用四、Cheerio库的基本使用五、结合req
阅读更多...
使用Python处理CSV和Excel文件的操作方法

使用Python处理CSV和Excel文件的操作方法

《使用Python处理CSV和Excel文件的操作方法》在数据分析、自动化和日常开发中,CSV和Excel文件是非常常见的数据存储格式,ython提供了强大的工具来读取、编辑和保存这两种文件,满足从基... 目录1. CSV 文件概述和处理方法1.1 CSV 文件格式的基本介绍1.2 使用 python 内
阅读更多...
如何使用celery进行异步处理和定时任务(django)

如何使用celery进行异步处理和定时任务(django)

《如何使用celery进行异步处理和定时任务(django)》文章介绍了Celery的基本概念、安装方法、如何使用Celery进行异步任务处理以及如何设置定时任务,通过Celery,可以在Web应用中... 目录一、celery的作用二、安装celery三、使用celery 异步执行任务四、使用celery
阅读更多...
SpringBoot操作spark处理hdfs文件的操作方法

SpringBoot操作spark处理hdfs文件的操作方法

《SpringBoot操作spark处理hdfs文件的操作方法》本文介绍了如何使用SpringBoot操作Spark处理HDFS文件,包括导入依赖、配置Spark信息、编写Controller和Ser... 目录SpringBoot操作spark处理hdfs文件1、导入依赖2、配置spark信息3、cont
阅读更多...
MyBatis延迟加载的处理方案

MyBatis延迟加载的处理方案

《MyBatis延迟加载的处理方案》MyBatis支持延迟加载（LazyLoading）,允许在需要数据时才从数据库加载,而不是在查询结果第一次返回时就立即加载所有数据,延迟加载的核心思想是,将关联对... 目录MyBATis如何处理延迟加载？延迟加载的原理1. 开启延迟加载2. 延迟加载的配置2.1 使用
阅读更多...
Android WebView的加载超时处理方案

Android WebView的加载超时处理方案

《AndroidWebView的加载超时处理方案》在Android开发中,WebView是一个常用的组件,用于在应用中嵌入网页,然而,当网络状况不佳或页面加载过慢时,用户可能会遇到加载超时的问题,本... 目录引言一、WebView加载超时的原因二、加载超时处理方案1. 使用Handler和Timer进行超
阅读更多...
Python中处理NaN值的技巧分享

Python中处理NaN值的技巧分享

《Python中处理NaN值的技巧分享》在数据科学和数据分析领域,NaN（NotaNumber）是一个常见的概念,它表示一个缺失或未定义的数值,在Python中,尤其是在使用pandas库处理数据时,... 目录NaN 值的来源和影响使用 pandas 的 isna()和 isnull()函数直接比较 Na
阅读更多...
详解Python中通用工具类与异常处理

详解Python中通用工具类与异常处理

《详解Python中通用工具类与异常处理》在Python开发中,编写可重用的工具类和通用的异常处理机制是提高代码质量和开发效率的关键,本文将介绍如何将特定的异常类改写为更通用的ValidationEx... 目录1. 通用异常类：ValidationException2. 通用工具类：Utils3. 示例文
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2