4. vb2 内存分配器接口：vb2_mem_ops 结构与内存类型枚举

Videobuf2 框架的核心设计理念之一是将缓冲区内存管理与视频流处理逻辑解耦。这一解耦通过 vb2_mem_ops 结构体实现，它为上层提供了统一的内存操作接口，而底层则根据不同的内存类型（如连续物理内存、分散/聚集内存、用户态指针、DMA-BUF）提供具体的实现。

4.1 内存类型枚举：v4l2_memory

V4L2 通过 v4l2_memory 枚举定义了四种标准的内存模型，驱动和应用程序通过 VIDIOC_REQBUFS 和 VIDIOC_QUERYBUF 交互时使用该枚举。

4.2 vb2_mem_ops 结构体解析

vb2_mem_ops 定义在 include/media/videobuf2-memops.h 中，是每个内存分配器后端必须实现的回调集合。以下是核心回调函数及其职责：

struct vb2_mem_ops {
    // 分配内存
    void *(*alloc)(struct device *dev, unsigned long attrs,
                   unsigned long size, enum dma_data_direction dma_dir,
                   gfp_t gfp_flags);
    // 释放内存
    void (*put)(void *buf_priv);
    // 获取用户空间指针对应的 DMA 地址
    int (*get_userptr)(struct device *dev, unsigned long vaddr,
                       unsigned long size, enum dma_data_direction dma_dir,
                       struct vb2_plane *planes);
    // 释放用户指针映射
    void (*put_userptr)(void *buf_priv);
    // 附加 DMA-BUF 文件描述符
    int (*attach_dmabuf)(struct device *dev, struct dma_buf *dbuf,
                         unsigned long size, enum dma_data_direction dma_dir,
                         struct vb2_plane *planes);
    // 分离 DMA-BUF
    void (*detach_dmabuf)(void *buf_priv);
    // 映射 DMA-BUF 到设备地址空间
    int (*map_dmabuf)(void *buf_priv);
    // 取消映射 DMA-BUF
    void (*unmap_dmabuf)(void *buf_priv);
    // 获取 DMA 地址和长度（用于 MMAP 模式）
    int (*get_dma_addr)(struct device *dev, void *buf_priv,
                        unsigned long *dma_addr, unsigned long *size);
    // 初始化分配器（可选）
    int (*init)(struct vb2_queue *q);
    // 清理分配器（可选）
    void (*cleanup)(struct vb2_queue *q);
};

4.3 核心回调详解

4.3.1 alloc / put：内存的分配与释放

• alloc：分配 size 字节的 DMA 缓冲区，返回一个私有句柄 buf_priv。参数 attrs 携带 DMA 属性（如 DMA_ATTR_NO_KERNEL_MAPPING），dma_dir 指明数据方向（DMA_FROM_DEVICE / DMA_TO_DEVICE）。
• put：释放由 alloc 分配的缓冲区。调用后 buf_priv 不再有效。

4.3.2 get_userptr / put_userptr：用户指针模式

• get_userptr：接收用户空间虚拟地址 vaddr，将其物理页锁定并映射到设备 DMA 地址空间，填充 vb2_plane 结构。
• put_userptr：解除锁定和映射，释放 DMA 地址。

4.3.3 attach_dmabuf / detach_dmabuf / map_dmabuf / unmap_dmabuf：DMA-BUF 模式

• attach_dmabuf：将外部传入的 struct dma_buf * 附加到当前设备，验证大小和方向，返回私有句柄。
• map_dmabuf：将附加的 DMA-BUF 映射到设备 I/O 地址空间，返回映射后的地址。
• unmap_dmabuf：解除设备映射。
• detach_dmabuf：分离 DMA-BUF，释放附加时分配的资源。

4.4 内存分配器架构图

下图展示了 vb2_mem_ops 如何将 V4L2 核心与三种主流内存后端连接起来：

4.5 内存类型与分配器后端对应关系

不同的 v4l2_memory 枚举值会触发内核选择不同的 vb2_mem_ops 实现。Linux 内核内置了三个标准后端：

4.6 回调调用流程（以 MMAP 模式为例）

1. REQBUFS 阶段： 驱动调用 vb2_core_reqbufs，根据内存类型选择后端，然后调用 ops->alloc 为每个缓冲区分配内存。
2. QUERYBUF 阶段： 调用 ops->get_dma_addr 获取 DMA 地址和大小，填充 v4l2_buffer 结构。
3. QBUF / DQBUF 阶段： 硬件通过 DMA 地址直接访问缓冲区，无需调用内存操作回调。
4. STREAMOFF / REQBUFS(0) 阶段： 调用 ops->put 释放所有缓冲区内存。

4.7 自定义分配器注册

驱动开发者可以通过 vb2_queue 的 mem_ops 字段注册自定义分配器：

struct vb2_queue q;
q.mem_ops = &my_custom_mem_ops;  // 替换默认分配器
q.memory = V4L2_MEMORY_MMAP;    // 指定内存类型
vb2_queue_init(&q);