[media] media: Documentation: remove V4L2_FL_USE_FH_PRIO flag
authorRamakrishnan Muthukrishnan <ramakrmu@cisco.com>
Thu, 19 Jun 2014 17:23:00 +0000 (14:23 -0300)
committerMauro Carvalho Chehab <m.chehab@samsung.com>
Fri, 4 Jul 2014 19:16:11 +0000 (16:16 -0300)
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>
Documentation/video4linux/v4l2-framework.txt
Documentation/video4linux/v4l2-pci-skeleton.c
Documentation/zh_CN/video4linux/v4l2-framework.txt

index 667a43361706c28c5343944de9836b40009cad8b..a11dff07ef71ed82cc9fcc08161af349285137a1 100644 (file)
@@ -675,11 +675,6 @@ You should also set these fields:
   video_device is initialized you *do* know which parent PCI device to use and
   so you set dev_device to the correct PCI device.
 
-- flags: optional. Set to V4L2_FL_USE_FH_PRIO if you want to let the framework
-  handle the VIDIOC_G/S_PRIORITY ioctls. This requires that you use struct
-  v4l2_fh. Eventually this flag will disappear once all drivers use the core
-  priority handling. But for now it has to be set explicitly.
-
 If you use v4l2_ioctl_ops, then you should set .unlocked_ioctl to video_ioctl2
 in your v4l2_file_operations struct.
 
@@ -909,8 +904,7 @@ struct v4l2_fh
 
 struct v4l2_fh provides a way to easily keep file handle specific data
 that is used by the V4L2 framework. New drivers must use struct v4l2_fh
-since it is also used to implement priority handling (VIDIOC_G/S_PRIORITY)
-if the video_device flag V4L2_FL_USE_FH_PRIO is also set.
+since it is also used to implement priority handling (VIDIOC_G/S_PRIORITY).
 
 The users of v4l2_fh (in the V4L2 framework, not the driver) know
 whether a driver uses v4l2_fh as its file->private_data pointer by
index 46904fe49609372eee7b6e16474fc2ac5fa1f5c1..006721e43b2a81f4ed4809696cc85c2e7326efda 100644 (file)
@@ -883,11 +883,6 @@ static int skeleton_probe(struct pci_dev *pdev, const struct pci_device_id *ent)
        vdev->v4l2_dev = &skel->v4l2_dev;
        /* Supported SDTV standards, if any */
        vdev->tvnorms = SKEL_TVNORMS;
-       /* If this bit is set, then the v4l2 core will provide the support
-        * for the VIDIOC_G/S_PRIORITY ioctls. This flag will eventually
-        * go away once all drivers have been converted to use struct v4l2_fh.
-        */
-       set_bit(V4L2_FL_USE_FH_PRIO, &vdev->flags);
        video_set_drvdata(vdev, skel);
 
        ret = video_register_device(vdev, VFL_TYPE_GRABBER, -1);
index 0da95dbaef341e08daa9033e4cf9a5d906804130..2b828e631e318c3cf2ace087b732bcaa18cb06ff 100644 (file)
@@ -580,11 +580,6 @@ release()回调必须被设置,且在最后一个 video_device 用户退出之
   v4l2_device 无法与特定的 PCI 设备关联,所有没有设置父设备。但当
   video_device 配置后,就知道使用哪个父 PCI 设备了。
 
-- flags:可选。如果你要让框架处理设置 VIDIOC_G/S_PRIORITY ioctls,
-  请设置 V4L2_FL_USE_FH_PRIO。这要求你使用 v4l2_fh 结构体。
-  一旦所有驱动使用了核心的优先级处理,最终这个标志将消失。但现在它
-  必须被显式设置。
-
 如果你使用 v4l2_ioctl_ops,则应该在 v4l2_file_operations 结构体中
 设置 .unlocked_ioctl 指向 video_ioctl2。
 
@@ -789,7 +784,7 @@ v4l2_fh 结构体
 -------------
 
 v4l2_fh 结构体提供一个保存用于 V4L2 框架的文件句柄特定数据的简单方法。
-如果 video_device 的 flag 设置了 V4L2_FL_USE_FH_PRIO 标志,新驱动
+如果 video_device 标志,新驱动
 必须使用 v4l2_fh 结构体,因为它也用于实现优先级处理(VIDIOC_G/S_PRIORITY)。
 
 v4l2_fh 的用户(位于 V4l2 框架中,并非驱动)可通过测试