diff options
author | Hans Verkuil <hans.verkuil@cisco.com> | 2012-09-14 06:44:20 -0300 |
---|---|---|
committer | Mauro Carvalho Chehab <mchehab@redhat.com> | 2012-09-26 09:46:39 -0300 |
commit | 663dc7f3a02712e22ef81f4c7b7b1caecceb8e4f (patch) | |
tree | dd5ccbbd1f8c35503828de677d84a52845b1a78f /Documentation/DocBook/media/v4l/vidioc-g-std.xml | |
parent | 2cca7d4e4dec86c20631612163b83477db4404c5 (diff) | |
download | op-kernel-dev-663dc7f3a02712e22ef81f4c7b7b1caecceb8e4f.zip op-kernel-dev-663dc7f3a02712e22ef81f4c7b7b1caecceb8e4f.tar.gz |
[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.xml | 10 |
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 99ff1a0..4a89841 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> |