3. 中断服务例程(ISR)基础：ISR注册、ISR执行上下文、ISR最小化原则

中断服务例程（Interrupt Service Routine, ISR）是WDM驱动响应硬件中断的核心代码路径。本章聚焦ISR的注册机制、执行上下文约束以及设计时必须遵循的最小化原则，帮助开发者构建高效、稳定的中断处理逻辑。

3.1 ISR注册：从INF文件到内核调用链

WDM驱动通过INF文件声明中断资源，并在DriverEntry或AddDevice中调用IoConnectInterrupt完成ISR注册。注册过程将ISR函数与中断向量、处理器亲和性、中断模式绑定。

// ISR注册核心代码片段
NTSTATUS RegisterInterrupt(PDEVICE_OBJECT DeviceObject, PDEVICE_EXTENSION DevExt) {
    CM_PARTIAL_RESOURCE_LIST *pResourceList = NULL;
    // 从IRP_MN_START_DEVICE中获取资源
    // ... 资源解析逻辑 ...
    
    // 注册ISR
    NTSTATUS status = IoConnectInterrupt(
        &DevExt->InterruptObject,           // 输出：中断对象句柄
        (PKSERVICE_ROUTINE)InterruptServiceRoutine, // ISR函数
        DevExt,                             // ISR上下文（ServiceContext）
        NULL,                               // 自旋锁（可选）
        DevExt->InterruptVector,            // 中断向量
        DevExt->InterruptLevel,             // 中断级别（IRQL）
        DevExt->InterruptAffinity,          // 处理器亲和性
        FALSE,                              // 是否共享中断
        EdgeTriggered,                      // 触发模式
        FALSE,                              // 是否支持DPC
        0,                                  // 旋转向量（x86专用）
        Latched                             // 中断模式
    );
    return status;
}

3.2 ISR执行上下文：DIRQL与中断优先级

ISR在DIRQL（Device IRQL）上执行，这是WDM中仅次于高IRQL（如PROFILE_LEVEL）的优先级。在DIRQL上，当前CPU屏蔽了所有低于或等于该IRQL的中断，确保ISR对设备寄存器的访问不被其他中断干扰。

ISR执行上下文的三个关键特征：

• 不可抢占：同一CPU上，DIRQL中断不能被同级或低级中断抢占，但可被更高级中断（如PROFILE_LEVEL）打断。
• 无分页：DIRQL上无法处理页错误，所有ISR访问的内存必须是非分页内存（NonPagedPool）。
• 无上下文切换：ISR不能等待、不能睡眠、不能获取需要等待的锁（如快速互斥体）。

3.3 ISR最小化原则：快速响应与延迟处理

ISR最小化原则是WDM中断设计的核心准则：ISR只做必须立即完成的工作，其余全部推迟到DPC（Deferred Procedure Call）中处理。这是因为ISR在DIRQL上执行，长时间占用DIRQL会阻塞其他设备的中断，降低系统整体响应性。

3.4 ISR返回值与中断识别

ISR返回BOOLEAN值，告知系统是否真正处理了中断。对于共享中断，此返回值至关重要。

// ISR标准实现模板
BOOLEAN InterruptServiceRoutine(
    _In_ struct _KINTERRUPT *Interrupt,
    _In_ PVOID ServiceContext          // 设备扩展指针
) {
    PDEVICE_EXTENSION devExt = (PDEVICE_EXTENSION)ServiceContext;
    BOOLEAN recognized = FALSE;
    
    // 1. 读取设备中断状态寄存器
    ULONG status = READ_REGISTER_ULONG(devExt->InterruptStatusReg);
    
    // 2. 判断是否为本设备中断
    if (status & devExt->InterruptMask) {
        recognized = TRUE;
        
        // 3. 清除中断标志（必须立即执行）
        WRITE_REGISTER_ULONG(devExt->InterruptClearReg, devExt->InterruptMask);
        
        // 4. 记录最小状态（非分页内存）
        devExt->LastInterruptStatus = status;
        
        // 5. 请求DPC处理剩余工作
        IoRequestDpc(devExt->DeviceObject, NULL, NULL);
    }
    
    // 6. 返回是否识别
    return recognized;
}

3.5 ISR设计常见错误与避坑

• 错误1：在ISR中调用KeSetEvent — 如果事件是自动重置事件且等待线程在DISPATCH_LEVEL以下，会导致IRQL违规。应改为在DPC中设置事件。
• 错误2：ISR中访问分页内存 — 分页内存可能在DIRQL上引发页错误，导致系统崩溃。所有ISR访问的数据必须分配自NonPagedPool。
• 错误3：ISR执行时间过长 — 超过100微秒的ISR会显著增加系统中断延迟。使用性能分析工具（如Xperf）测量ISR耗时。
• 错误4：未处理共享中断识别 — 在共享中断配置下，ISR必须通过硬件寄存器确认中断归属，不能假设每次调用都是本设备中断。
• 错误5：ISR中调用KeAcquireSpinLock — 自旋锁可以在DIRQL上获取，但必须确保锁的IRQL匹配，且释放顺序正确。推荐使用中断自旋锁（InterruptSpinLock）。