summaryrefslogtreecommitdiff
path: root/Documentation/DocBook/media/v4l/vidioc-g-std.xml
diff options
context:
space:
mode:
authorHans Verkuil <hans.verkuil@cisco.com>2012-09-14 13:44:20 +0400
committerMauro Carvalho Chehab <mchehab@redhat.com>2012-09-26 16:46:39 +0400
commit663dc7f3a02712e22ef81f4c7b7b1caecceb8e4f (patch)
treedd5ccbbd1f8c35503828de677d84a52845b1a78f /Documentation/DocBook/media/v4l/vidioc-g-std.xml
parent2cca7d4e4dec86c20631612163b83477db4404c5 (diff)
downloadlinux-663dc7f3a02712e22ef81f4c7b7b1caecceb8e4f.tar.xz
[media] DocBook: document when to return ENODATA
ENODATA should be returned if the API used for getting, changing, querying or enumerating the current video timings is not supported by the current input or output. This was decided during the 2012 Media Workshop. Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com> Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
Diffstat (limited to 'Documentation/DocBook/media/v4l/vidioc-g-std.xml')
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-g-std.xml10
1 files changed, 9 insertions, 1 deletions
diff --git a/Documentation/DocBook/media/v4l/vidioc-g-std.xml b/Documentation/DocBook/media/v4l/vidioc-g-std.xml
index 99ff1a016220..4a898417de28 100644
--- a/Documentation/DocBook/media/v4l/vidioc-g-std.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-g-std.xml
@@ -72,7 +72,9 @@ flags, being a write-only ioctl it does not return the actual new standard as
the current input does not support the requested standard the driver
returns an &EINVAL;. When the standard set is ambiguous drivers may
return <errorcode>EINVAL</errorcode> or choose any of the requested
-standards.</para>
+standards. If the current input or output does not support standard video timings (e.g. if
+&VIDIOC-ENUMINPUT; does not set the <constant>V4L2_IN_CAP_STD</constant> flag), then
+&ENODATA; is returned.</para>
</refsect1>
<refsect1>
@@ -85,6 +87,12 @@ standards.</para>
<para>The <constant>VIDIOC_S_STD</constant> parameter was unsuitable.</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><errorcode>ENODATA</errorcode></term>
+ <listitem>
+ <para>Standard video timings are not supported for this input or output.</para>
+ </listitem>
+ </varlistentry>
</variablelist>
</refsect1>
</refentry>