Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

[media] media: Documentation: remove V4L2_FL_USE_FH_PRIO flag

The V4L2_FL_USE_FH_PRIO has been removed from the code, now remove it from the
documentation.

Signed-off-by: Ramakrishnan Muthukrishnan <ramakrmu@cisco.com>
Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

authored by

Ramakrishnan Muthukrishnan and committed by
Mauro Carvalho Chehab
ff792c85 dc3094a7

+2 -18
+1 -7
Documentation/video4linux/v4l2-framework.txt
··· 675 675 video_device is initialized you *do* know which parent PCI device to use and 676 676 so you set dev_device to the correct PCI device. 677 677 678 - - flags: optional. Set to V4L2_FL_USE_FH_PRIO if you want to let the framework 679 - handle the VIDIOC_G/S_PRIORITY ioctls. This requires that you use struct 680 - v4l2_fh. Eventually this flag will disappear once all drivers use the core 681 - priority handling. But for now it has to be set explicitly. 682 - 683 678 If you use v4l2_ioctl_ops, then you should set .unlocked_ioctl to video_ioctl2 684 679 in your v4l2_file_operations struct. 685 680 ··· 904 909 905 910 struct v4l2_fh provides a way to easily keep file handle specific data 906 911 that is used by the V4L2 framework. New drivers must use struct v4l2_fh 907 - since it is also used to implement priority handling (VIDIOC_G/S_PRIORITY) 908 - if the video_device flag V4L2_FL_USE_FH_PRIO is also set. 912 + since it is also used to implement priority handling (VIDIOC_G/S_PRIORITY). 909 913 910 914 The users of v4l2_fh (in the V4L2 framework, not the driver) know 911 915 whether a driver uses v4l2_fh as its file->private_data pointer by
-5
Documentation/video4linux/v4l2-pci-skeleton.c
··· 883 883 vdev->v4l2_dev = &skel->v4l2_dev; 884 884 /* Supported SDTV standards, if any */ 885 885 vdev->tvnorms = SKEL_TVNORMS; 886 - /* If this bit is set, then the v4l2 core will provide the support 887 - * for the VIDIOC_G/S_PRIORITY ioctls. This flag will eventually 888 - * go away once all drivers have been converted to use struct v4l2_fh. 889 - */ 890 - set_bit(V4L2_FL_USE_FH_PRIO, &vdev->flags); 891 886 video_set_drvdata(vdev, skel); 892 887 893 888 ret = video_register_device(vdev, VFL_TYPE_GRABBER, -1);
+1 -6
Documentation/zh_CN/video4linux/v4l2-framework.txt
··· 580 580 v4l2_device 无法与特定的 PCI 设备关联,所有没有设置父设备。但当 581 581 video_device 配置后,就知道使用哪个父 PCI 设备了。 582 582 583 - - flags:可选。如果你要让框架处理设置 VIDIOC_G/S_PRIORITY ioctls, 584 - 请设置 V4L2_FL_USE_FH_PRIO。这要求你使用 v4l2_fh 结构体。 585 - 一旦所有驱动使用了核心的优先级处理,最终这个标志将消失。但现在它 586 - 必须被显式设置。 587 - 588 583 如果你使用 v4l2_ioctl_ops,则应该在 v4l2_file_operations 结构体中 589 584 设置 .unlocked_ioctl 指向 video_ioctl2。 590 585 ··· 784 789 ------------- 785 790 786 791 v4l2_fh 结构体提供一个保存用于 V4L2 框架的文件句柄特定数据的简单方法。 787 - 如果 video_device 的 flag 设置了 V4L2_FL_USE_FH_PRIO 标志,新驱动 792 + 如果 video_device 标志,新驱动 788 793 必须使用 v4l2_fh 结构体,因为它也用于实现优先级处理(VIDIOC_G/S_PRIORITY)。 789 794 790 795 v4l2_fh 的用户(位于 V4l2 框架中,并非驱动)可通过测试