diff options
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/video4linux/v4l2-framework.txt | 8 | ||||
-rw-r--r-- | Documentation/video4linux/v4l2-pci-skeleton.c | 5 | ||||
-rw-r--r-- | Documentation/zh_CN/video4linux/v4l2-framework.txt | 7 |
3 files changed, 2 insertions, 18 deletions
diff --git a/Documentation/video4linux/v4l2-framework.txt b/Documentation/video4linux/v4l2-framework.txt index 667a43361706..a11dff07ef71 100644 --- a/Documentation/video4linux/v4l2-framework.txt +++ b/Documentation/video4linux/v4l2-framework.txt | |||
@@ -675,11 +675,6 @@ You should also set these fields: | |||
675 | video_device is initialized you *do* know which parent PCI device to use and | 675 | video_device is initialized you *do* know which parent PCI device to use and |
676 | so you set dev_device to the correct PCI device. | 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 | If you use v4l2_ioctl_ops, then you should set .unlocked_ioctl to video_ioctl2 | 678 | If you use v4l2_ioctl_ops, then you should set .unlocked_ioctl to video_ioctl2 |
684 | in your v4l2_file_operations struct. | 679 | in your v4l2_file_operations struct. |
685 | 680 | ||
@@ -909,8 +904,7 @@ struct v4l2_fh | |||
909 | 904 | ||
910 | struct v4l2_fh provides a way to easily keep file handle specific data | 905 | struct v4l2_fh provides a way to easily keep file handle specific data |
911 | that is used by the V4L2 framework. New drivers must use struct v4l2_fh | 906 | that is used by the V4L2 framework. New drivers must use struct v4l2_fh |
912 | since it is also used to implement priority handling (VIDIOC_G/S_PRIORITY) | 907 | since it is also used to implement priority handling (VIDIOC_G/S_PRIORITY). |
913 | if the video_device flag V4L2_FL_USE_FH_PRIO is also set. | ||
914 | 908 | ||
915 | The users of v4l2_fh (in the V4L2 framework, not the driver) know | 909 | The users of v4l2_fh (in the V4L2 framework, not the driver) know |
916 | whether a driver uses v4l2_fh as its file->private_data pointer by | 910 | whether a driver uses v4l2_fh as its file->private_data pointer by |
diff --git a/Documentation/video4linux/v4l2-pci-skeleton.c b/Documentation/video4linux/v4l2-pci-skeleton.c index 46904fe49609..006721e43b2a 100644 --- a/Documentation/video4linux/v4l2-pci-skeleton.c +++ b/Documentation/video4linux/v4l2-pci-skeleton.c | |||
@@ -883,11 +883,6 @@ static int skeleton_probe(struct pci_dev *pdev, const struct pci_device_id *ent) | |||
883 | vdev->v4l2_dev = &skel->v4l2_dev; | 883 | vdev->v4l2_dev = &skel->v4l2_dev; |
884 | /* Supported SDTV standards, if any */ | 884 | /* Supported SDTV standards, if any */ |
885 | vdev->tvnorms = SKEL_TVNORMS; | 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 | video_set_drvdata(vdev, skel); | 886 | video_set_drvdata(vdev, skel); |
892 | 887 | ||
893 | ret = video_register_device(vdev, VFL_TYPE_GRABBER, -1); | 888 | ret = video_register_device(vdev, VFL_TYPE_GRABBER, -1); |
diff --git a/Documentation/zh_CN/video4linux/v4l2-framework.txt b/Documentation/zh_CN/video4linux/v4l2-framework.txt index 0da95dbaef34..2b828e631e31 100644 --- a/Documentation/zh_CN/video4linux/v4l2-framework.txt +++ b/Documentation/zh_CN/video4linux/v4l2-framework.txt | |||
@@ -580,11 +580,6 @@ release()回调必须被设置,且在最后一个 video_device 用户退出之 | |||
580 | v4l2_device 无法与特定的 PCI 设备关联,所有没有设置父设备。但当 | 580 | v4l2_device 无法与特定的 PCI 设备关联,所有没有设置父设备。但当 |
581 | video_device 配置后,就知道使用哪个父 PCI 设备了。 | 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 | 如果你使用 v4l2_ioctl_ops,则应该在 v4l2_file_operations 结构体中 | 583 | 如果你使用 v4l2_ioctl_ops,则应该在 v4l2_file_operations 结构体中 |
589 | 设置 .unlocked_ioctl 指向 video_ioctl2。 | 584 | 设置 .unlocked_ioctl 指向 video_ioctl2。 |
590 | 585 | ||
@@ -789,7 +784,7 @@ v4l2_fh 结构体 | |||
789 | ------------- | 784 | ------------- |
790 | 785 | ||
791 | v4l2_fh 结构体提供一个保存用于 V4L2 框架的文件句柄特定数据的简单方法。 | 786 | v4l2_fh 结构体提供一个保存用于 V4L2 框架的文件句柄特定数据的简单方法。 |
792 | 如果 video_device 的 flag 设置了 V4L2_FL_USE_FH_PRIO 标志,新驱动 | 787 | 如果 video_device 标志,新驱动 |
793 | 必须使用 v4l2_fh 结构体,因为它也用于实现优先级处理(VIDIOC_G/S_PRIORITY)。 | 788 | 必须使用 v4l2_fh 结构体,因为它也用于实现优先级处理(VIDIOC_G/S_PRIORITY)。 |
794 | 789 | ||
795 | v4l2_fh 的用户(位于 V4l2 框架中,并非驱动)可通过测试 | 790 | v4l2_fh 的用户(位于 V4l2 框架中,并非驱动)可通过测试 |