Based on kernel version 3.9. Page generated on 2013-05-02 23:04 EST.
1 <refentry id="vidioc-query-dv-preset"> 2 <refmeta> 3 <refentrytitle>ioctl VIDIOC_QUERY_DV_PRESET</refentrytitle> 4 &manvol; 5 </refmeta> 6 7 <refnamediv> 8 <refname>VIDIOC_QUERY_DV_PRESET</refname> 9 <refpurpose>Sense the DV preset received by the current 10 input</refpurpose> 11 </refnamediv> 12 13 <refsynopsisdiv> 14 <funcsynopsis> 15 <funcprototype> 16 <funcdef>int <function>ioctl</function></funcdef> 17 <paramdef>int <parameter>fd</parameter></paramdef> 18 <paramdef>int <parameter>request</parameter></paramdef> 19 <paramdef>struct v4l2_dv_preset *<parameter>argp</parameter></paramdef> 20 </funcprototype> 21 </funcsynopsis> 22 </refsynopsisdiv> 23 24 <refsect1> 25 <title>Arguments</title> 26 27 <variablelist> 28 <varlistentry> 29 <term><parameter>fd</parameter></term> 30 <listitem> 31 <para>&fd;</para> 32 </listitem> 33 </varlistentry> 34 <varlistentry> 35 <term><parameter>request</parameter></term> 36 <listitem> 37 <para>VIDIOC_QUERY_DV_PRESET</para> 38 </listitem> 39 </varlistentry> 40 <varlistentry> 41 <term><parameter>argp</parameter></term> 42 <listitem> 43 <para></para> 44 </listitem> 45 </varlistentry> 46 </variablelist> 47 </refsect1> 48 49 <refsect1> 50 <title>Description</title> 51 52 <para>This ioctl is <emphasis role="bold">deprecated</emphasis>. 53 New drivers and applications should use &VIDIOC-QUERY-DV-TIMINGS; instead. 54 </para> 55 56 <para>The hardware may be able to detect the current DV preset 57 automatically, similar to sensing the video standard. To do so, applications 58 call <constant> VIDIOC_QUERY_DV_PRESET</constant> with a pointer to a 59 &v4l2-dv-preset; type. Once the hardware detects a preset, that preset is 60 returned in the preset field of &v4l2-dv-preset;. If the preset could not be 61 detected because there was no signal, or the signal was unreliable, or the 62 signal did not map to a supported preset, then the value V4L2_DV_INVALID is 63 returned.</para> 64 </refsect1> 65 66 <refsect1> 67 &return-value; 68 69 <variablelist> 70 <varlistentry> 71 <term><errorcode>ENODATA</errorcode></term> 72 <listitem> 73 <para>Digital video presets are not supported for this input or output.</para> 74 </listitem> 75 </varlistentry> 76 </variablelist> 77 </refsect1> 78 </refentry>