2.27. V4L2 常用函数和数据结构¶

int v4l2_ctrl_query_fill(struct v4l2_queryctrl *qctrl, s32 min, s32 max, s32 step, s32 def)¶: 填充 struct v4l2_queryctrl

参数

struct v4l2_queryctrl *qctrl: 指向要填充的 struct v4l2_queryctrl 的指针
s32 min: 控制的最小值
s32 max: 控制的最大值
s32 step: 控制步长
s32 def: 控制的默认值

描述

填充查询控制的 struct v4l2_queryctrl 字段。

注意

此函数假定 qctrl->id 字段已填充。

如果 V4L2 核心不识别该控件，则返回 -EINVAL；成功时返回 0。

enum v4l2_i2c_tuner_type¶: 指定在搜索 I2C 设备时应使用的调谐器地址范围。

常量

ADDRS_RADIO: 无线电调谐器地址。表示以下 I2C 地址：0x10（如果使用 tea5761 支持编译）和 0x60。
ADDRS_DEMOD: 解调调谐器地址。表示以下 I2C 地址：0x42、0x43、0x4a 和 0x4b。
ADDRS_TV: 电视调谐器地址。表示以下 I2C 地址：0x42、0x43、0x4a、0x4b、0x60、0x61、0x62、0x63 和 0x64。
ADDRS_TV_WITH_DEMOD: 如果存在解调器，则为电视调谐器地址，这会将解调器使用的地址从候选列表中排除。表示以下 I2C 地址：0x60、0x61、0x62、0x63 和 0x64。

注意

以上所有 I2C 地址都使用 7 位表示法。

struct v4l2_subdev *v4l2_i2c_new_subdev(struct v4l2_device *v4l2_dev, struct i2c_adapter *adapter, const char *client_type, u8 addr, const unsigned short *probe_addrs)¶: 加载 i2c 模块并返回初始化的 struct v4l2_subdev。

参数

struct v4l2_device *v4l2_dev: 指向 struct v4l2_device 的指针
struct i2c_adapter *adapter: 指向 struct i2c_adapter 的指针
const char *client_type: 适配器上的芯片名称。
u8 addr: I2C 地址。如果为零，它将使用 probe_addrs
const unsigned short *probe_addrs: 包含地址列表的数组。此类数组的最后一个条目应为 I2C_CLIENT_END。

描述

返回 struct v4l2_subdev 指针。

struct v4l2_subdev *v4l2_i2c_new_subdev_board(struct v4l2_device *v4l2_dev, struct i2c_adapter *adapter, struct i2c_board_info *info, const unsigned short *probe_addrs)¶: 加载 i2c 模块并返回初始化的 struct v4l2_subdev。

参数

struct v4l2_device *v4l2_dev: 指向 struct v4l2_device 的指针
struct i2c_adapter *adapter: 指向 struct i2c_adapter 的指针
struct i2c_board_info *info: 指向 struct i2c_board_info 的指针，用于替换 irq、platform_data 和 addr 参数。
const unsigned short *probe_addrs: 包含地址列表的数组。此类数组的最后一个条目应为 I2C_CLIENT_END。

描述

返回 struct v4l2_subdev 指针。

void v4l2_i2c_subdev_set_name(struct v4l2_subdev *sd, struct i2c_client *client, const char *devname, const char *postfix)¶: 为 I²C 子设备设置名称

参数

struct v4l2_subdev *sd: 指向 struct v4l2_subdev 的指针
struct i2c_client *client: 指向 struct i2c_client 的指针
const char *devname: 设备名称；如果为 NULL，将使用 I²C 设备驱动的名称
const char *postfix: 子设备特定的字符串，放在 I²C 设备名称之后；可以为 NULL

void v4l2_i2c_subdev_init(struct v4l2_subdev *sd, struct i2c_client *client, const struct v4l2_subdev_ops *ops)¶: 使用来自 i2c_client 结构的数据初始化一个 struct v4l2_subdev。

参数

struct v4l2_subdev *sd: 指向 struct v4l2_subdev 的指针
struct i2c_client *client: 指向 struct i2c_client 的指针
const struct v4l2_subdev_ops *ops: 指向 struct v4l2_subdev_ops 的指针

unsigned short v4l2_i2c_subdev_addr(struct v4l2_subdev *sd)¶: 返回 struct v4l2_subdev 的 i2c 客户端地址。

参数

struct v4l2_subdev *sd: 指向 struct v4l2_subdev 的指针

描述

返回 I2C 子设备的地址

const unsigned short *v4l2_i2c_tuner_addrs(enum v4l2_i2c_tuner_type type)¶: 返回要探测的 I2C 调谐器地址列表。

参数

enum v4l2_i2c_tuner_type type: 要查找的调谐器类型，由 enum v4l2_i2c_tuner_type 定义。

注意

仅在调谐器地址未知时使用。

void v4l2_i2c_subdev_unregister(struct v4l2_subdev *sd)¶: 注销 v4l2_subdev

参数

struct v4l2_subdev *sd: 指向 struct v4l2_subdev 的指针

struct v4l2_subdev *v4l2_spi_new_subdev(struct v4l2_device *v4l2_dev, struct spi_controller *ctlr, struct spi_board_info *info)¶: 加载一个 spi 模块并返回一个初始化的 struct v4l2_subdev。

参数

struct v4l2_device *v4l2_dev: 指向 struct v4l2_device 的指针。
struct spi_controller *ctlr: 指向 struct spi_controller 的指针。
struct spi_board_info *info: 指向 struct spi_board_info 的指针。

描述

返回 struct v4l2_subdev 指针。

void v4l2_spi_subdev_init(struct v4l2_subdev *sd, struct spi_device *spi, const struct v4l2_subdev_ops *ops)¶: 使用来自 spi_device 结构的数据初始化 v4l2_subdev。

参数

struct v4l2_subdev *sd: 指向 struct v4l2_subdev 的指针
struct spi_device *spi: 指向 struct spi_device 的指针。
const struct v4l2_subdev_ops *ops: 指向 struct v4l2_subdev_ops 的指针

void v4l2_spi_subdev_unregister(struct v4l2_subdev *sd)¶: 注销 v4l2_subdev

参数

struct v4l2_subdev *sd: 指向 struct v4l2_subdev 的指针

void v4l_bound_align_image(unsigned int *width, unsigned int wmin, unsigned int wmax, unsigned int walign, unsigned int *height, unsigned int hmin, unsigned int hmax, unsigned int halign, unsigned int salign)¶: 根据给定的约束调整视频尺寸。

参数

unsigned int *width: 指向宽度值的指针，如果需要，该值将被调整。
unsigned int wmin: 最小宽度。
unsigned int wmax: 最大宽度。
unsigned int walign: 宽度上的最低有效位。
unsigned int *height: 指向高度值的指针，如果需要，该值将被调整。
unsigned int hmin: 最小高度。
unsigned int hmax: 最大高度。
unsigned int halign: 高度上的最低有效位。
unsigned int salign: 图像大小的最低有效位（例如， $width * height$ ）。

描述

裁剪图像，使宽度介于 wmin 和 wmax 之间，高度介于 hmin 和 hmax 之间（包括边界值）。

此外，宽度将是 $2^{walign}$ 的倍数，高度将是 $2^{halign}$ 的倍数，并且总大小 $width * height$ 将是 $2^{salign}$ 的倍数。

注意

可以缩小或放大裁剪矩形以适应对齐约束。
wmax 不得小于 wmin。
hmax 不得小于 hmin。
对齐值不能太高，以至于在允许的范围内没有可能的图像尺寸。
wmin 和 hmin 必须至少为 1（不要使用 0）。
对于 walign、halign 和 salign，如果您不关心某个对齐方式，请指定 0，因为 $2^0 = 1$ ，并且一个字节的对齐等同于不对齐。
如果您只想向下调整，请指定与初始值相同的最大值。

v4l2_find_nearest_size¶

v4l2_find_nearest_size (array, array_size, width_field, height_field, width, height)

在一个驱动程序特定结构的数组中查找离散分辨率集中最接近的大小。

参数

array: 驱动程序特定的图像大小数组
array_size: 驱动程序特定的图像大小数组的长度
width_field: 驱动程序特定结构中宽度字段的名称
height_field: 驱动程序特定结构中高度字段的名称
width: 所需的宽度。
height: 所需的高度。

描述

查找最接近的分辨率，以最小化请求的分辨率和支持的分辨率之间的宽度和高度差异。驱动程序特定结构中宽度和高度字段的大小必须等于 u32 的大小，即 4 个字节。

如果数组长度为零，则返回最佳匹配项或 NULL。

int v4l2_g_parm_cap(struct video_device *vdev, struct v4l2_subdev *sd, struct v4l2_streamparm *a)¶: 用于 vidioc_g_parm 的辅助例程，通过调用给定子设备的 get_frame_interval op 来填充此参数。它仅适用于 V4L2_BUF_TYPE_VIDEO_CAPTURE(_MPLANE)，因此函数名称中带有 _cap。

参数

struct video_device *vdev: struct video_device 指针。用于确定设备功能。
struct v4l2_subdev *sd: 子设备指针。
struct v4l2_streamparm *a: VIDIOC_G_PARM 参数。

int v4l2_s_parm_cap(struct video_device *vdev, struct v4l2_subdev *sd, struct v4l2_streamparm *a)¶: 用于 vidioc_s_parm 的辅助例程，通过调用给定子设备的 set_frame_interval op 来填充此参数。它仅适用于 V4L2_BUF_TYPE_VIDEO_CAPTURE(_MPLANE)，因此函数名称中带有 _cap。

参数

struct video_device *vdev: struct video_device 指针。用于确定设备功能。
struct v4l2_subdev *sd: 子设备指针。
struct v4l2_streamparm *a: VIDIOC_S_PARM 参数。

enum v4l2_pixel_encoding¶: 指定像素编码值

常量

V4L2_PIXEL_ENC_UNKNOWN: 像素编码未知/未初始化
V4L2_PIXEL_ENC_YUV: 像素编码为 YUV
V4L2_PIXEL_ENC_RGB: 像素编码为 RGB
V4L2_PIXEL_ENC_BAYER: 像素编码为拜耳

struct v4l2_format_info¶: 关于 V4L2 格式的信息

定义:

struct v4l2_format_info {
    u32 format;
    u8 pixel_enc;
    u8 mem_planes;
    u8 comp_planes;
    u8 bpp[4];
    u8 bpp_div[4];
    u8 hdiv;
    u8 vdiv;
    u8 block_w[4];
    u8 block_h[4];
};

成员

format: 4CC 格式标识符 (V4L2_PIX_FMT_*)
pixel_enc: 像素编码（请参见上面的enum v4l2_pixel_encoding）
mem_planes: 内存平面数，包括 alpha 平面（1 到 4）。
comp_planes: 组件平面数，包括 alpha 平面（1 到 4）。
bpp: 每个平面的每像素字节数数组
bpp_div: 每个平面的每像素字节数除数数组，用于支持小数像素大小。
hdiv: 水平色度子采样因子
vdiv: 垂直色度子采样因子
block_w: 每个平面的宏块像素宽度（可选）
block_h: 每个平面的宏块像素高度（可选）

s64 v4l2_get_link_freq(struct v4l2_ctrl_handler *handler, unsigned int mul, unsigned int div)¶: 从发射器获取链路速率

参数

struct v4l2_ctrl_handler *handler: 发射器的控制处理程序
unsigned int mul: 像素速率和链路频率之间的乘数。D-PHY 上的每像素位数，并行上的每个时钟采样数。否则为 0。
unsigned int div: 像素速率和链路频率之间的除数。D-PHY 上的数据通道数乘以 2，并行上为 1。否则为 0。

描述

此函数旨在从发射器子设备获取链路频率。它返回链路速率，可以是从发射器实现的 V4L2_CID_LINK_FREQ 控件返回的链路速率，也可以是根据发射器实现的 V4L2_CID_PIXEL_RATE 计算的值。

返回

>0：链路频率
-ENOENT：未找到链路频率或像素速率控制
-EINVAL：链路频率值无效

int v4l2_link_freq_to_bitmap(struct device *dev, const u64 *fw_link_freqs, unsigned int num_of_fw_link_freqs, const s64 *driver_link_freqs, unsigned int num_of_driver_link_freqs, unsigned long *bitmap)¶: 找出平台支持的链路频率

参数

struct device *dev: struct device
const u64 *fw_link_freqs: 来自固件的链路频率数组
unsigned int num_of_fw_link_freqs: fw_link_freqs 中的条目数
const s64 *driver_link_freqs: 驱动程序支持的链路频率数组
unsigned int num_of_driver_link_freqs: driver_link_freqs 中的条目数
unsigned long *bitmap: 在 fw_link_freqs 中找到的驱动程序支持的链路频率的位图

描述

此函数检查系统固件中启用了哪些驱动程序支持的链路频率，并在 bitmap 中设置相应的位（在首次将其清零之后）。

返回

0：成功
-ENOENT：在驱动程序支持的链路频率和固件中可用的链路频率之间未找到匹配项。
-ENODATA：固件中未指定链路频率。

struct v4l2_ioctl_ops¶: 描述每个 V4L2 ioctl 的操作

定义:

struct v4l2_ioctl_ops {
    int (*vidioc_querycap)(struct file *file, void *fh, struct v4l2_capability *cap);
    int (*vidioc_enum_fmt_vid_cap)(struct file *file, void *fh, struct v4l2_fmtdesc *f);
    int (*vidioc_enum_fmt_vid_overlay)(struct file *file, void *fh, struct v4l2_fmtdesc *f);
    int (*vidioc_enum_fmt_vid_out)(struct file *file, void *fh, struct v4l2_fmtdesc *f);
    int (*vidioc_enum_fmt_sdr_cap)(struct file *file, void *fh, struct v4l2_fmtdesc *f);
    int (*vidioc_enum_fmt_sdr_out)(struct file *file, void *fh, struct v4l2_fmtdesc *f);
    int (*vidioc_enum_fmt_meta_cap)(struct file *file, void *fh, struct v4l2_fmtdesc *f);
    int (*vidioc_enum_fmt_meta_out)(struct file *file, void *fh, struct v4l2_fmtdesc *f);
    int (*vidioc_g_fmt_vid_cap)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_g_fmt_vid_overlay)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_g_fmt_vid_out)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_g_fmt_vid_out_overlay)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_g_fmt_vbi_cap)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_g_fmt_vbi_out)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_g_fmt_sliced_vbi_cap)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_g_fmt_sliced_vbi_out)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_g_fmt_vid_cap_mplane)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_g_fmt_vid_out_mplane)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_g_fmt_sdr_cap)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_g_fmt_sdr_out)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_g_fmt_meta_cap)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_g_fmt_meta_out)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_s_fmt_vid_cap)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_s_fmt_vid_overlay)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_s_fmt_vid_out)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_s_fmt_vid_out_overlay)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_s_fmt_vbi_cap)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_s_fmt_vbi_out)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_s_fmt_sliced_vbi_cap)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_s_fmt_sliced_vbi_out)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_s_fmt_vid_cap_mplane)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_s_fmt_vid_out_mplane)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_s_fmt_sdr_cap)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_s_fmt_sdr_out)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_s_fmt_meta_cap)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_s_fmt_meta_out)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_try_fmt_vid_cap)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_try_fmt_vid_overlay)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_try_fmt_vid_out)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_try_fmt_vid_out_overlay)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_try_fmt_vbi_cap)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_try_fmt_vbi_out)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_try_fmt_sliced_vbi_cap)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_try_fmt_sliced_vbi_out)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_try_fmt_vid_cap_mplane)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_try_fmt_vid_out_mplane)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_try_fmt_sdr_cap)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_try_fmt_sdr_out)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_try_fmt_meta_cap)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_try_fmt_meta_out)(struct file *file, void *fh, struct v4l2_format *f);
    int (*vidioc_reqbufs)(struct file *file, void *fh, struct v4l2_requestbuffers *b);
    int (*vidioc_querybuf)(struct file *file, void *fh, struct v4l2_buffer *b);
    int (*vidioc_qbuf)(struct file *file, void *fh, struct v4l2_buffer *b);
    int (*vidioc_expbuf)(struct file *file, void *fh, struct v4l2_exportbuffer *e);
    int (*vidioc_dqbuf)(struct file *file, void *fh, struct v4l2_buffer *b);
    int (*vidioc_create_bufs)(struct file *file, void *fh, struct v4l2_create_buffers *b);
    int (*vidioc_prepare_buf)(struct file *file, void *fh, struct v4l2_buffer *b);
    int (*vidioc_remove_bufs)(struct file *file, void *fh, struct v4l2_remove_buffers *d);
    int (*vidioc_overlay)(struct file *file, void *fh, unsigned int i);
    int (*vidioc_g_fbuf)(struct file *file, void *fh, struct v4l2_framebuffer *a);
    int (*vidioc_s_fbuf)(struct file *file, void *fh, const struct v4l2_framebuffer *a);
    int (*vidioc_streamon)(struct file *file, void *fh, enum v4l2_buf_type i);
    int (*vidioc_streamoff)(struct file *file, void *fh, enum v4l2_buf_type i);
    int (*vidioc_g_std)(struct file *file, void *fh, v4l2_std_id *norm);
    int (*vidioc_s_std)(struct file *file, void *fh, v4l2_std_id norm);
    int (*vidioc_querystd)(struct file *file, void *fh, v4l2_std_id *a);
    int (*vidioc_enum_input)(struct file *file, void *fh, struct v4l2_input *inp);
    int (*vidioc_g_input)(struct file *file, void *fh, unsigned int *i);
    int (*vidioc_s_input)(struct file *file, void *fh, unsigned int i);
    int (*vidioc_enum_output)(struct file *file, void *fh, struct v4l2_output *a);
    int (*vidioc_g_output)(struct file *file, void *fh, unsigned int *i);
    int (*vidioc_s_output)(struct file *file, void *fh, unsigned int i);
    int (*vidioc_queryctrl)(struct file *file, void *fh, struct v4l2_queryctrl *a);
    int (*vidioc_query_ext_ctrl)(struct file *file, void *fh, struct v4l2_query_ext_ctrl *a);
    int (*vidioc_g_ctrl)(struct file *file, void *fh, struct v4l2_control *a);
    int (*vidioc_s_ctrl)(struct file *file, void *fh, struct v4l2_control *a);
    int (*vidioc_g_ext_ctrls)(struct file *file, void *fh, struct v4l2_ext_controls *a);
    int (*vidioc_s_ext_ctrls)(struct file *file, void *fh, struct v4l2_ext_controls *a);
    int (*vidioc_try_ext_ctrls)(struct file *file, void *fh, struct v4l2_ext_controls *a);
    int (*vidioc_querymenu)(struct file *file, void *fh, struct v4l2_querymenu *a);
    int (*vidioc_enumaudio)(struct file *file, void *fh, struct v4l2_audio *a);
    int (*vidioc_g_audio)(struct file *file, void *fh, struct v4l2_audio *a);
    int (*vidioc_s_audio)(struct file *file, void *fh, const struct v4l2_audio *a);
    int (*vidioc_enumaudout)(struct file *file, void *fh, struct v4l2_audioout *a);
    int (*vidioc_g_audout)(struct file *file, void *fh, struct v4l2_audioout *a);
    int (*vidioc_s_audout)(struct file *file, void *fh, const struct v4l2_audioout *a);
    int (*vidioc_g_modulator)(struct file *file, void *fh, struct v4l2_modulator *a);
    int (*vidioc_s_modulator)(struct file *file, void *fh, const struct v4l2_modulator *a);
    int (*vidioc_g_pixelaspect)(struct file *file, void *fh, int buf_type, struct v4l2_fract *aspect);
    int (*vidioc_g_selection)(struct file *file, void *fh, struct v4l2_selection *s);
    int (*vidioc_s_selection)(struct file *file, void *fh, struct v4l2_selection *s);
    int (*vidioc_g_jpegcomp)(struct file *file, void *fh, struct v4l2_jpegcompression *a);
    int (*vidioc_s_jpegcomp)(struct file *file, void *fh, const struct v4l2_jpegcompression *a);
    int (*vidioc_g_enc_index)(struct file *file, void *fh, struct v4l2_enc_idx *a);
    int (*vidioc_encoder_cmd)(struct file *file, void *fh, struct v4l2_encoder_cmd *a);
    int (*vidioc_try_encoder_cmd)(struct file *file, void *fh, struct v4l2_encoder_cmd *a);
    int (*vidioc_decoder_cmd)(struct file *file, void *fh, struct v4l2_decoder_cmd *a);
    int (*vidioc_try_decoder_cmd)(struct file *file, void *fh, struct v4l2_decoder_cmd *a);
    int (*vidioc_g_parm)(struct file *file, void *fh, struct v4l2_streamparm *a);
    int (*vidioc_s_parm)(struct file *file, void *fh, struct v4l2_streamparm *a);
    int (*vidioc_g_tuner)(struct file *file, void *fh, struct v4l2_tuner *a);
    int (*vidioc_s_tuner)(struct file *file, void *fh, const struct v4l2_tuner *a);
    int (*vidioc_g_frequency)(struct file *file, void *fh, struct v4l2_frequency *a);
    int (*vidioc_s_frequency)(struct file *file, void *fh, const struct v4l2_frequency *a);
    int (*vidioc_enum_freq_bands)(struct file *file, void *fh, struct v4l2_frequency_band *band);
    int (*vidioc_g_sliced_vbi_cap)(struct file *file, void *fh, struct v4l2_sliced_vbi_cap *a);
    int (*vidioc_log_status)(struct file *file, void *fh);
    int (*vidioc_s_hw_freq_seek)(struct file *file, void *fh, const struct v4l2_hw_freq_seek *a);
#ifdef CONFIG_VIDEO_ADV_DEBUG;
    int (*vidioc_g_register)(struct file *file, void *fh, struct v4l2_dbg_register *reg);
    int (*vidioc_s_register)(struct file *file, void *fh, const struct v4l2_dbg_register *reg);
    int (*vidioc_g_chip_info)(struct file *file, void *fh, struct v4l2_dbg_chip_info *chip);
#endif;
    int (*vidioc_enum_framesizes)(struct file *file, void *fh, struct v4l2_frmsizeenum *fsize);
    int (*vidioc_enum_frameintervals)(struct file *file, void *fh, struct v4l2_frmivalenum *fival);
    int (*vidioc_s_dv_timings)(struct file *file, void *fh, struct v4l2_dv_timings *timings);
    int (*vidioc_g_dv_timings)(struct file *file, void *fh, struct v4l2_dv_timings *timings);
    int (*vidioc_query_dv_timings)(struct file *file, void *fh, struct v4l2_dv_timings *timings);
    int (*vidioc_enum_dv_timings)(struct file *file, void *fh, struct v4l2_enum_dv_timings *timings);
    int (*vidioc_dv_timings_cap)(struct file *file, void *fh, struct v4l2_dv_timings_cap *cap);
    int (*vidioc_g_edid)(struct file *file, void *fh, struct v4l2_edid *edid);
    int (*vidioc_s_edid)(struct file *file, void *fh, struct v4l2_edid *edid);
    int (*vidioc_subscribe_event)(struct v4l2_fh *fh, const struct v4l2_event_subscription *sub);
    int (*vidioc_unsubscribe_event)(struct v4l2_fh *fh, const struct v4l2_event_subscription *sub);
    long (*vidioc_default)(struct file *file, void *fh, bool valid_prio, unsigned int cmd, void *arg);
};

成员

vidioc_querycap: 指向实现 VIDIOC_QUERYCAP ioctl 的函数的指针
vidioc_enum_fmt_vid_cap: 指向实现 VIDIOC_ENUM_FMT ioctl 逻辑的函数的指针，用于单平面和多平面模式下的视频捕获
vidioc_enum_fmt_vid_overlay: 指向实现 VIDIOC_ENUM_FMT ioctl 逻辑的函数的指针，用于视频覆盖
vidioc_enum_fmt_vid_out: 指向实现 VIDIOC_ENUM_FMT ioctl 逻辑的函数的指针，用于单平面和多平面模式下的视频输出
vidioc_enum_fmt_sdr_cap: 指向实现 VIDIOC_ENUM_FMT ioctl 逻辑的函数的指针，用于软件定义无线电捕获
vidioc_enum_fmt_sdr_out: 指向实现软件定义无线电输出的 VIDIOC_ENUM_FMT ioctl 逻辑的函数的指针
vidioc_enum_fmt_meta_cap: 指向实现元数据捕获的 VIDIOC_ENUM_FMT ioctl 逻辑的函数的指针
vidioc_enum_fmt_meta_out: 指向实现元数据输出的 VIDIOC_ENUM_FMT ioctl 逻辑的函数的指针
vidioc_g_fmt_vid_cap: 指向实现单平面模式下视频捕获的 VIDIOC_G_FMT ioctl 逻辑的函数的指针
vidioc_g_fmt_vid_overlay: 指向实现视频覆盖的 VIDIOC_G_FMT ioctl 逻辑的函数的指针
vidioc_g_fmt_vid_out: 指向实现单平面模式下视频输出的 VIDIOC_G_FMT ioctl 逻辑的函数的指针
vidioc_g_fmt_vid_out_overlay: 指向实现视频覆盖输出的 VIDIOC_G_FMT ioctl 逻辑的函数的指针
vidioc_g_fmt_vbi_cap: 指向实现原始 VBI 捕获的 VIDIOC_G_FMT ioctl 逻辑的函数的指针
vidioc_g_fmt_vbi_out: 指向实现原始 VBI 输出的 VIDIOC_G_FMT ioctl 逻辑的函数的指针
vidioc_g_fmt_sliced_vbi_cap: 指向实现分片 VBI 捕获的 VIDIOC_G_FMT ioctl 逻辑的函数的指针
vidioc_g_fmt_sliced_vbi_out: 指向实现分片 VBI 输出的 VIDIOC_G_FMT ioctl 逻辑的函数的指针
vidioc_g_fmt_vid_cap_mplane: 指向实现多平面模式下视频捕获的 VIDIOC_G_FMT ioctl 逻辑的函数的指针
vidioc_g_fmt_vid_out_mplane: 指向实现多平面模式下视频输出的 VIDIOC_G_FMT ioctl 逻辑的函数的指针
vidioc_g_fmt_sdr_cap: 指向实现软件定义无线电捕获的 VIDIOC_G_FMT ioctl 逻辑的函数的指针
vidioc_g_fmt_sdr_out: 指向实现软件定义无线电输出的 VIDIOC_G_FMT ioctl 逻辑的函数的指针
vidioc_g_fmt_meta_cap: 指向实现元数据捕获的 VIDIOC_G_FMT ioctl 逻辑的函数的指针
vidioc_g_fmt_meta_out: 指向实现元数据输出的 VIDIOC_G_FMT ioctl 逻辑的函数的指针
vidioc_s_fmt_vid_cap: 指向实现单平面模式下视频捕获的 VIDIOC_S_FMT ioctl 逻辑的函数的指针
vidioc_s_fmt_vid_overlay: 指向实现视频覆盖的 VIDIOC_S_FMT ioctl 逻辑的函数的指针
vidioc_s_fmt_vid_out: 指向实现单平面模式下视频输出的 VIDIOC_S_FMT ioctl 逻辑的函数的指针
vidioc_s_fmt_vid_out_overlay: 指向实现视频覆盖输出的 VIDIOC_S_FMT ioctl 逻辑的函数的指针
vidioc_s_fmt_vbi_cap: 指向实现原始 VBI 捕获的 VIDIOC_S_FMT ioctl 逻辑的函数的指针
vidioc_s_fmt_vbi_out: 指向实现原始 VBI 输出的 VIDIOC_S_FMT ioctl 逻辑的函数的指针
vidioc_s_fmt_sliced_vbi_cap: 指向实现分片 VBI 捕获的 VIDIOC_S_FMT ioctl 逻辑的函数的指针
vidioc_s_fmt_sliced_vbi_out: 指向实现分片 VBI 输出的 VIDIOC_S_FMT ioctl 逻辑的函数的指针
vidioc_s_fmt_vid_cap_mplane: 指向实现多平面模式下视频捕获的 VIDIOC_S_FMT ioctl 逻辑的函数的指针
vidioc_s_fmt_vid_out_mplane: 指向实现多平面模式下视频输出的 VIDIOC_S_FMT ioctl 逻辑的函数的指针
vidioc_s_fmt_sdr_cap: 指向实现软件定义无线电捕获的 VIDIOC_S_FMT ioctl 逻辑的函数的指针
vidioc_s_fmt_sdr_out: 指向实现软件定义无线电输出的 VIDIOC_S_FMT ioctl 逻辑的函数的指针
vidioc_s_fmt_meta_cap: 指向实现元数据捕获的 VIDIOC_S_FMT ioctl 逻辑的函数的指针
vidioc_s_fmt_meta_out: 指向实现元数据输出的 VIDIOC_S_FMT ioctl 逻辑的函数的指针
vidioc_try_fmt_vid_cap: 指向实现单平面模式下视频捕获的 VIDIOC_TRY_FMT ioctl 逻辑的函数的指针
vidioc_try_fmt_vid_overlay: 指向实现视频覆盖的 VIDIOC_TRY_FMT ioctl 逻辑的函数的指针
vidioc_try_fmt_vid_out: 指向实现单平面模式下视频输出的 VIDIOC_TRY_FMT ioctl 逻辑的函数的指针
vidioc_try_fmt_vid_out_overlay: 指向实现视频覆盖输出的 VIDIOC_TRY_FMT ioctl 逻辑的函数的指针
vidioc_try_fmt_vbi_cap: 指向实现原始 VBI 捕获的 VIDIOC_TRY_FMT ioctl 逻辑的函数的指针
vidioc_try_fmt_vbi_out: 指向实现原始 VBI 输出的 VIDIOC_TRY_FMT ioctl 逻辑的函数的指针
vidioc_try_fmt_sliced_vbi_cap: 指向实现分片 VBI 捕获的 VIDIOC_TRY_FMT ioctl 逻辑的函数的指针
vidioc_try_fmt_sliced_vbi_out: 指向实现分片 VBI 输出的 VIDIOC_TRY_FMT ioctl 逻辑的函数的指针
vidioc_try_fmt_vid_cap_mplane: 指向实现多平面模式下视频捕获的 VIDIOC_TRY_FMT ioctl 逻辑的函数的指针
vidioc_try_fmt_vid_out_mplane: 指向实现多平面模式下视频输出的 VIDIOC_TRY_FMT ioctl 逻辑的函数的指针
vidioc_try_fmt_sdr_cap: 指向实现软件定义无线电捕获的 VIDIOC_TRY_FMT ioctl 逻辑的函数的指针
vidioc_try_fmt_sdr_out: 指向实现软件定义无线电输出的 VIDIOC_TRY_FMT ioctl 逻辑的函数的指针
vidioc_try_fmt_meta_cap: 指向实现元数据捕获的 VIDIOC_TRY_FMT ioctl 逻辑的函数的指针
vidioc_try_fmt_meta_out: 指向实现元数据输出的 VIDIOC_TRY_FMT ioctl 逻辑的函数的指针
vidioc_reqbufs: 指向实现 VIDIOC_REQBUFS ioctl 的函数的指针
vidioc_querybuf: 指向实现 VIDIOC_QUERYBUF ioctl 的函数的指针
vidioc_qbuf: 指向实现 VIDIOC_QBUF ioctl 的函数的指针
vidioc_expbuf: 指向实现 VIDIOC_EXPBUF ioctl 的函数的指针
vidioc_dqbuf: 指向实现 VIDIOC_DQBUF ioctl 的函数的指针
vidioc_create_bufs: 指向实现 VIDIOC_CREATE_BUFS ioctl 的函数的指针
vidioc_prepare_buf: 指向实现 VIDIOC_PREPARE_BUF ioctl 的函数的指针
vidioc_remove_bufs: 指向实现 VIDIOC_REMOVE_BUFS ioctl 的函数的指针
vidioc_overlay: 指向实现 VIDIOC_OVERLAY ioctl 的函数的指针
vidioc_g_fbuf: 指向实现 VIDIOC_G_FBUF ioctl 的函数的指针
vidioc_s_fbuf: 指向实现 VIDIOC_S_FBUF ioctl 的函数的指针
vidioc_streamon: 指向实现 VIDIOC_STREAMON ioctl 的函数的指针
vidioc_streamoff: 指向实现 VIDIOC_STREAMOFF ioctl 的函数的指针
vidioc_g_std: 指向实现 VIDIOC_G_STD ioctl 的函数的指针
vidioc_s_std: 指向实现 VIDIOC_S_STD ioctl 的函数的指针
vidioc_querystd: 指向实现 VIDIOC_QUERYSTD ioctl 的函数的指针
vidioc_enum_input: 指向实现 VIDIOC_ENUM_INPUT ioctl 的函数的指针
vidioc_g_input: 指向实现 VIDIOC_G_INPUT ioctl 的函数的指针
vidioc_s_input: 指向实现 VIDIOC_S_INPUT ioctl 的函数的指针
vidioc_enum_output: 指向实现 VIDIOC_ENUM_OUTPUT ioctl 的函数的指针
vidioc_g_output: 指向实现 VIDIOC_G_OUTPUT ioctl 的函数的指针
vidioc_s_output: 指向实现 VIDIOC_S_OUTPUT ioctl 的函数的指针
vidioc_queryctrl: 指向实现 VIDIOC_QUERYCTRL ioctl 的函数的指针
vidioc_query_ext_ctrl: 指向实现 VIDIOC_QUERY_EXT_CTRL ioctl 的函数的指针
vidioc_g_ctrl: 指向实现 VIDIOC_G_CTRL ioctl 的函数的指针
vidioc_s_ctrl: 指向实现 VIDIOC_S_CTRL ioctl 的函数的指针
vidioc_g_ext_ctrls: 指向实现 VIDIOC_G_EXT_CTRLS ioctl 的函数的指针
vidioc_s_ext_ctrls: 指向实现 VIDIOC_S_EXT_CTRLS ioctl 的函数的指针
vidioc_try_ext_ctrls: 指向实现 VIDIOC_TRY_EXT_CTRLS ioctl 的函数的指针
vidioc_querymenu: 指向实现 VIDIOC_QUERYMENU ioctl 的函数的指针
vidioc_enumaudio: 指向实现 VIDIOC_ENUMAUDIO ioctl 的函数的指针
vidioc_g_audio: 指向实现 VIDIOC_G_AUDIO ioctl 的函数的指针
vidioc_s_audio: 指向实现 VIDIOC_S_AUDIO ioctl 的函数的指针
vidioc_enumaudout: 指向实现 VIDIOC_ENUMAUDOUT ioctl 的函数的指针
vidioc_g_audout: 指向实现 VIDIOC_G_AUDOUT ioctl 的函数的指针
vidioc_s_audout: 指向实现 VIDIOC_S_AUDOUT ioctl 的函数的指针
vidioc_g_modulator: 指向实现 VIDIOC_G_MODULATOR ioctl 的函数的指针
vidioc_s_modulator: 指向实现 VIDIOC_S_MODULATOR ioctl 的函数的指针
vidioc_g_pixelaspect: 指向实现 VIDIOC_CROPCAP ioctl 的 pixelaspect 部分的函数的指针
vidioc_g_selection: 指向实现 VIDIOC_G_SELECTION ioctl 的函数的指针
vidioc_s_selection: 指向实现 VIDIOC_S_SELECTION ioctl 的函数的指针
vidioc_g_jpegcomp: 指向实现 VIDIOC_G_JPEGCOMP ioctl 的函数的指针
vidioc_s_jpegcomp: 指向实现 VIDIOC_S_JPEGCOMP ioctl 的函数的指针
vidioc_g_enc_index: 指向实现 VIDIOC_G_ENC_INDEX ioctl 的函数的指针
vidioc_encoder_cmd: 指向实现 VIDIOC_ENCODER_CMD ioctl 的函数的指针
vidioc_try_encoder_cmd: 指向实现 VIDIOC_TRY_ENCODER_CMD ioctl 的函数的指针
vidioc_decoder_cmd: 指向实现 VIDIOC_DECODER_CMD ioctl 的函数的指针
vidioc_try_decoder_cmd: 指向实现 VIDIOC_TRY_DECODER_CMD ioctl 的函数的指针
vidioc_g_parm: 指向实现 VIDIOC_G_PARM ioctl 的函数的指针
vidioc_s_parm: 指向实现 VIDIOC_S_PARM ioctl 的函数的指针
vidioc_g_tuner: 指向实现 VIDIOC_G_TUNER ioctl 的函数的指针
vidioc_s_tuner: 指向实现 VIDIOC_S_TUNER ioctl 的函数的指针
vidioc_g_frequency: 指向实现 VIDIOC_G_FREQUENCY ioctl 的函数的指针
vidioc_s_frequency: 指向实现 VIDIOC_S_FREQUENCY ioctl 的函数的指针
vidioc_enum_freq_bands: 指向实现 VIDIOC_ENUM_FREQ_BANDS ioctl 的函数的指针
vidioc_g_sliced_vbi_cap: 指向实现 VIDIOC_G_SLICED_VBI_CAP ioctl 的函数的指针
vidioc_log_status: 指向实现 VIDIOC_LOG_STATUS ioctl 的函数的指针
vidioc_s_hw_freq_seek: 指向实现 VIDIOC_S_HW_FREQ_SEEK ioctl 的函数的指针
vidioc_g_register: 指向实现 VIDIOC_DBG_G_REGISTER ioctl 的函数的指针
vidioc_s_register: 指向实现 VIDIOC_DBG_S_REGISTER ioctl 的函数的指针
vidioc_g_chip_info: 指向实现 VIDIOC_DBG_G_CHIP_INFO ioctl 的函数的指针
vidioc_enum_framesizes: 指向实现 VIDIOC_ENUM_FRAMESIZES ioctl 的函数的指针
vidioc_enum_frameintervals: 指向实现 VIDIOC_ENUM_FRAMEINTERVALS ioctl 的函数的指针
vidioc_s_dv_timings: 指向实现 VIDIOC_S_DV_TIMINGS ioctl 的函数的指针
vidioc_g_dv_timings: 指向实现 VIDIOC_G_DV_TIMINGS ioctl 的函数的指针
vidioc_query_dv_timings: 指向实现 VIDIOC_QUERY_DV_TIMINGS ioctl 的函数的指针
vidioc_enum_dv_timings: 指向实现 VIDIOC_ENUM_DV_TIMINGS ioctl 的函数的指针
vidioc_dv_timings_cap: 指向实现 VIDIOC_DV_TIMINGS_CAP ioctl 的函数的指针
vidioc_g_edid: 指向实现 VIDIOC_G_EDID ioctl 的函数的指针
vidioc_s_edid: 指向实现 VIDIOC_S_EDID ioctl 的函数的指针
vidioc_subscribe_event: 指向实现 VIDIOC_SUBSCRIBE_EVENT ioctl 的函数的指针
vidioc_unsubscribe_event: 指向实现 VIDIOC_UNSUBSCRIBE_EVENT ioctl 的函数的指针
vidioc_default: 用于允许其他 ioctl 的指针

const char *v4l2_norm_to_name(v4l2_std_id id)¶: 辅助例程，用于从模拟电视标准的 ID 获取其名称。

参数

v4l2_std_id id: 模拟电视标准 ID。

返回

返回包含模拟电视标准名称的字符串。如果未找到该标准，或者如果 id 指向多个标准，则返回“Unknown”。

void v4l2_video_std_frame_period(int id, struct v4l2_fract *frameperiod)¶: 辅助例程，用默认帧率分数填充 struct v4l2_fract 指针。

参数

int id: 模拟电视标准 ID。
struct v4l2_fract *frameperiod: 指向要填充的v4l2_fract结构的指针

int v4l2_video_std_construct(struct v4l2_standard *vs, int id, const char *name)¶: 辅助例程，根据 id 参数填充 v4l2_standard 结构的字段。

参数

struct v4l2_standard *vs: 指向要填充的 v4l2_standard 结构的指针
int id: 模拟电视标准 ID。
const char *name: 要使用的标准名称

描述

注意

此辅助例程已过时。不应在新驱动程序中使用。

int v4l_video_std_enumstd(struct v4l2_standard *vs, v4l2_std_id id)¶: 辅助例程，根据 id 和 vs->index 参数填充 v4l2_standard 结构的字段。

参数

struct v4l2_standard *vs: 指向要填充的 v4l2_standard 结构的指针。
v4l2_std_id id: 模拟电视标准 ID。

void v4l_printk_ioctl(const char *prefix, unsigned int cmd)¶: 辅助例程，以人类可读的格式打印 ioctl。

参数

const char *prefix: 添加到 ioctl 打印中的前缀。
unsigned int cmd: ioctl 名称

描述

注意

如果 prefix != NULL，它将首先发出 printk(KERN_DEBUG "``s: “, prefix)``。

long int v4l2_compat_ioctl32(struct file *file, unsigned int cmd, unsigned long arg)¶: 适用于 64 位处理器的 32 位兼容性层

参数

struct file *file: 指向 file 结构的指针。
unsigned int cmd: Ioctl 名称。
unsigned long arg: Ioctl 参数。

v4l2_kioctl¶: 类型定义：用于传递 ioctl 处理程序的类型定义。

语法

long v4l2_kioctl (struct file *file, unsigned int cmd, void *arg)

参数

struct file *file: 指向 file 结构的指针。
unsigned int cmd: Ioctl 名称。
void *arg: Ioctl 参数。

long int video_usercopy(struct file *file, unsigned int cmd, unsigned long int arg, v4l2_kioctl func)¶: 在发出 ioctl 时从/向用户空间内存复制数据。

参数

struct file *file: 指向 file 结构的指针。
unsigned int cmd: Ioctl 名称。
unsigned long int arg: Ioctl 参数。
v4l2_kioctl func: 将处理 ioctl 的函数

描述

注意

此例程应仅在 V4L2 核心内部使用。

long int video_ioctl2(struct file *file, unsigned int cmd, unsigned long int arg)¶: 处理 V4L2 ioctl。

参数

struct file *file: 指向 file 结构的指针。
unsigned int cmd: Ioctl 名称。
unsigned long int arg: Ioctl 参数。

描述

用于处理 ioctl 的方法。应用于填充所有 V4L2 驱动程序上的 v4l2_ioctl_ops.unlocked_ioctl。

Linux 内核

目录

本页

2.27. V4L2 常用函数和数据结构¶