3. V4L2核心ioctl处理流程：v4l2_ioctl_ops结构体解析、标准ioctl分发机制、自定义ioctl扩展方法

V4L2（Video for Linux 2）框架的核心交互模式基于 ioctl 系统调用。用户空间应用程序通过 open() 获取设备文件描述符后，几乎所有的控制、配置、数据流管理操作都通过 ioctl() 完成。理解 V4L2 的 ioctl 处理流程，是编写高效、标准化的视频设备驱动的关键。

本章深入解析 v4l2_ioctl_ops 结构体、标准 ioctl 的分发机制，以及如何安全地扩展自定义 ioctl 命令。

3.1 v4l2_ioctl_ops 结构体解析

v4l2_ioctl_ops 是 V4L2 驱动中最重要的回调集合。它定义了驱动能够响应的所有标准 V4L2 ioctl 命令。该结构体包含数十个函数指针，按功能分为查询、控制、格式、缓冲、流管理等类别。

下表列出了 v4l2_ioctl_ops 中最重要的回调分组及其典型用途：

以下是一个典型的 v4l2_ioctl_ops 初始化片段：

static const struct v4l2_ioctl_ops my_camera_ioctl_ops = {
    .vidioc_querycap      = my_camera_querycap,
    .vidioc_enum_fmt_vid_cap = my_camera_enum_fmt,
    .vidioc_g_fmt_vid_cap    = my_camera_g_fmt,
    .vidioc_s_fmt_vid_cap    = my_camera_s_fmt,
    .vidioc_try_fmt_vid_cap  = my_camera_try_fmt,
    .vidioc_reqbufs          = my_camera_reqbufs,
    .vidioc_querybuf         = my_camera_querybuf,
    .vidioc_qbuf             = my_camera_qbuf,
    .vidioc_dqbuf            = my_camera_dqbuf,
    .vidioc_streamon         = my_camera_streamon,
    .vidioc_streamoff        = my_camera_streamoff,
    .vidioc_enum_input       = my_camera_enum_input,
    .vidioc_g_input          = my_camera_g_input,
    .vidioc_s_input          = my_camera_s_input,
};

3.2 标准ioctl分发机制

V4L2 核心框架实现了 video_ioctl2() 函数，作为所有 V4L2 设备文件 ioctl 的入口。该函数内部维护了一张巨大的 命令-回调映射表，将用户空间传入的 ioctl 命令号（如 VIDIOC_QUERYCAP）直接映射到 v4l2_ioctl_ops 中对应的回调函数。

分发流程如下：

1. 系统调用入口： 用户调用 ioctl(fd, VIDIOC_QUERYCAP, &cap)，触发内核 VFS 层的 unlocked_ioctl。
2. V4L2 核心接管： video_device 的 fops 中注册了 video_ioctl2()，该函数被调用。
3. 命令查找： video_ioctl2() 根据命令号在内部数组中二分查找或哈希查找，定位到对应的 v4l2_ioctl_info 条目。
4. 参数校验与转换： 核心框架自动处理用户空间与内核空间之间的数据拷贝（copy_from_user / copy_to_user），并校验参数合法性。
5. 回调调用： 核心框架通过 v4l2_ioctl_ops 中的函数指针调用驱动实现的回调。
6. 结果返回： 回调执行完毕后，核心框架将结果（成功或错误码）返回给用户空间。

下图展示了标准 ioctl 从用户空间到驱动回调的完整分发路径：

3.3 自定义ioctl扩展方法

虽然 V4L2 标准 ioctl 覆盖了绝大多数视频设备操作，但在某些场景下，驱动需要暴露非标准的硬件特性（如私有统计信息、特殊调试模式、固件升级）。此时，驱动开发者可以通过 自定义 ioctl 进行扩展。

V4L2 框架为自定义 ioctl 提供了两种主要方法：

方法一：使用 vidioc_default 回调（推荐）

v4l2_ioctl_ops 中包含一个特殊的回调 vidioc_default。当标准映射表中找不到对应的命令号时，V4L2 核心会调用此回调。驱动在此回调中实现自定义命令的分发。

实现步骤：

1. 定义自定义命令号： 使用 _IO()、_IOR()、_IOW()、_IOWR() 宏生成命令号。建议使用 BASE_VIDIOC_PRIVATE 作为起始偏移，避免与标准命令冲突。
2. 实现 vidioc_default 回调： 在回调中通过 switch 或 if-else 判断命令号，执行对应操作。
3. 注册回调： 将 vidioc_default 赋值到 v4l2_ioctl_ops 中。

/* 自定义命令定义 */
#define MY_CUSTOM_CMD_GET_STATS   _IOR('V', BASE_VIDIOC_PRIVATE + 0, struct my_stats)
#define MY_CUSTOM_CMD_SET_MODE    _IOW('V', BASE_VIDIOC_PRIVATE + 1, int)

/* vidioc_default 回调实现 */
static long my_camera_default(struct file *file, void *fh,
                              bool valid_prio, unsigned int cmd, void *arg)
{
    struct my_camera_dev *dev = video_drvdata(file);

    switch (cmd) {
    case MY_CUSTOM_CMD_GET_STATS: {
        struct my_stats stats;
        /* 填充统计信息 */
        stats.frame_count = dev->frame_count;
        stats.drop_count  = dev->drop_count;
        if (copy_to_user((void __user *)arg, &stats, sizeof(stats)))
            return -EFAULT;
        return 0;
    }
    case MY_CUSTOM_CMD_SET_MODE: {
        int mode;
        if (copy_from_user(&mode, (void __user *)arg, sizeof(mode)))
            return -EFAULT;
        /* 设置私有模式 */
        dev->custom_mode = mode;
        return 0;
    }
    default:
        return -ENOTTY;
    }
}

/* 在 v4l2_ioctl_ops 中注册 */
static const struct v4l2_ioctl_ops my_camera_ioctl_ops = {
    /* ... 标准回调 ... */
    .vidioc_default = my_camera_default,
};

方法二：直接替换 video_device 的 unlocked_ioctl（不推荐）

驱动可以直接覆盖 video_device 中 fops 的 unlocked_ioctl 指针，完全接管所有 ioctl 处理。但这种方法会绕过 V4L2 核心的所有安全校验和标准分发机制，容易引入安全漏洞，且与 V4L2 框架的兼容性差。除非有极其特殊的需求，否则应避免使用。

下图展示了自定义 ioctl 通过 vidioc_default 回调的处理路径：

3.4 标准 vs 自定义 ioctl 对比