3. DRM VBlank核心数据结构：drm_vblank_crtc结构体、vblank_count、enabled状态、queue与worker机制

DRM VBlank中断机制的核心数据结构和控制逻辑集中在 drm_vblank_crtc 结构体及其关联的计数、状态、队列和工作线程机制中。理解这些组件是掌握VBlank中断调度、帧同步以及HDR元数据精确投递的基础。

3.1 drm_vblank_crtc 结构体：VBlank中断的“控制中枢”

每个CRTC（显示控制器）在DRM内核侧都对应一个 drm_vblank_crtc 实例，该结构体封装了该CRTC所有与VBlank相关的状态、计数和同步原语。它是整个VBlank子系统的核心数据结构。

3.2 vblank_count：帧序列的“心跳计数器”

vblank_count（即 drm_vblank_crtc.count）是一个64位的原子计数器，从CRTC启用开始单调递增。它的核心作用包括：

• 帧序标记： 每个VBlank中断对应一个唯一的计数值，用户态应用可通过比较前后计数值判断是否发生了帧丢失。
• 时间戳关联： 每次计数递增时，DRM会同时记录高精度时间戳（ktime_t），形成“帧号-时间”映射，用于计算实际刷新率和帧间隔。
• HDR元数据投递时机： 在HDR场景下，驱动需要确保元数据（如 HDR_OUTPUT_METADATA）在特定的 vblank_count 时刻生效，避免撕裂或颜色闪烁。

// 内核中VBlank中断处理的核心递增逻辑（简化）
static void drm_handle_vblank_irq(struct drm_device *dev, unsigned int pipe)
{
    struct drm_vblank_crtc *vblank = &dev->vblank[pipe];
    
    // 1. 原子递增计数器
    atomic64_inc(&vblank->count);
    
    // 2. 记录高精度时间戳
    vblank->time = ktime_get();
    
    // 3. 唤醒等待队列中的用户态进程
    wake_up(&vblank->queue);
    
    // 4. 调度工作线程处理后续任务（如HDR元数据更新）
    kthread_queue_work(&dev->vblank_worker, &vblank->worker);
}

3.3 enabled状态：中断的“开关闸门”

enabled 标志控制着硬件VBlank中断的注册与注销。其状态转换遵循严格的引用计数规则：

1. 开启流程： 当第一个用户态进程调用 DRM_IOCTL_WAIT_VBLANK 或内核模块需要VBlank事件时，refcount 从0变为1，触发 drm_vblank_enable()，进而调用 dev->driver->enable_vblank() 钩子函数注册硬件中断。
2. 关闭流程： 当所有使用者释放VBlank引用后，refcount 归零，触发 drm_vblank_disable() 和 dev->driver->disable_vblank() 注销中断。
3. 模式切换保护： 在CRTC模式切换期间，inmodetransition 标志置位，即使 enabled 为 true，中断处理函数也会跳过部分操作，避免在时序不稳定时更新状态。

3.4 queue与worker机制：中断处理的“双阶段流水线”

DRM VBlank子系统采用“快速路径 + 慢速路径”的双阶段设计，通过 queue 和 worker 实现高效的事件分发。

第一阶段：硬中断上下文（快速路径）

• 执行 drm_handle_vblank_irq()。
• 原子递增 vblank_count，记录时间戳。
• 调用 wake_up(&vblank->queue) 唤醒阻塞在 DRM_IOCTL_WAIT_VBLANK 上的用户态进程。
• 通过 kthread_queue_work() 将 worker 提交到全局VBlank工作队列。
• 立即返回，中断处理时间控制在微秒级。

第二阶段：工作线程上下文（慢速路径）

• 执行 drm_vblank_worker() 回调函数。
• 处理HDR元数据更新：检查是否有待投递的 hdr_output_metadata，调用驱动钩子写入硬件寄存器。
• 触发 drm_crtc_vblank_event 回调，通知KMS组件帧完成。
• 执行其他可睡眠操作（如内存分配、文件系统操作）。

3.5 数据结构协同工作流程

以下表格总结了在典型VBlank中断处理过程中，各核心数据结构的协同关系：