Based on kernel version 3.9. Page generated on 2013-05-02 23:04 EST.
1 <refentry id="vidioc-g-dv-preset"> 2 <refmeta> 3 <refentrytitle>ioctl VIDIOC_G_DV_PRESET, VIDIOC_S_DV_PRESET</refentrytitle> 4 &manvol; 5 </refmeta> 6 7 <refnamediv> 8 <refname>VIDIOC_G_DV_PRESET</refname> 9 <refname>VIDIOC_S_DV_PRESET</refname> 10 <refpurpose>Query or select the DV preset of the current input or output</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_G_DV_PRESET, VIDIOC_S_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>These ioctls are <emphasis role="bold">deprecated</emphasis>. 53 New drivers and applications should use &VIDIOC-G-DV-TIMINGS; and &VIDIOC-S-DV-TIMINGS; 54 instead. 55 </para> 56 57 <para>To query and select the current DV preset, applications 58 use the <constant>VIDIOC_G_DV_PRESET</constant> and <constant>VIDIOC_S_DV_PRESET</constant> 59 ioctls which take a pointer to a &v4l2-dv-preset; type as argument. 60 Applications must zero the reserved array in &v4l2-dv-preset;. 61 <constant>VIDIOC_G_DV_PRESET</constant> returns a dv preset in the field 62 <structfield>preset</structfield> of &v4l2-dv-preset;.</para> 63 64 <para><constant>VIDIOC_S_DV_PRESET</constant> accepts a pointer to a &v4l2-dv-preset; 65 that has the preset value to be set. Applications must zero the reserved array in &v4l2-dv-preset;. 66 If the preset is not supported, it returns an &EINVAL; </para> 67 </refsect1> 68 69 <refsect1> 70 &return-value; 71 72 <variablelist> 73 <varlistentry> 74 <term><errorcode>EINVAL</errorcode></term> 75 <listitem> 76 <para>This ioctl is not supported, or the 77 <constant>VIDIOC_S_DV_PRESET</constant>,<constant>VIDIOC_S_DV_PRESET</constant> parameter was unsuitable.</para> 78 </listitem> 79 </varlistentry> 80 <varlistentry> 81 <term><errorcode>ENODATA</errorcode></term> 82 <listitem> 83 <para>Digital video presets are not supported for this input or output.</para> 84 </listitem> 85 </varlistentry> 86 <varlistentry> 87 <term><errorcode>EBUSY</errorcode></term> 88 <listitem> 89 <para>The device is busy and therefore can not change the preset.</para> 90 </listitem> 91 </varlistentry> 92 </variablelist> 93 94 <table pgwide="1" frame="none" id="v4l2-dv-preset"> 95 <title>struct <structname>v4l2_dv_preset</structname></title> 96 <tgroup cols="3"> 97 &cs-str; 98 <tbody valign="top"> 99 <row> 100 <entry>__u32</entry> 101 <entry><structfield>preset</structfield></entry> 102 <entry>Preset value to represent the digital video timings</entry> 103 </row> 104 <row> 105 <entry>__u32</entry> 106 <entry><structfield>reserved[4]</structfield></entry> 107 <entry>Reserved fields for future use</entry> 108 </row> 109 </tbody> 110 </tgroup> 111 </table> 112 </refsect1> 113 </refentry>