Home | History | Annotate | Download | only in spec 
      1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
      2 <HTML
      3 ><HEAD
      4 ><TITLE
      5 >V4L2 close()</TITLE
      6 ><META
      7 NAME="GENERATOR"
      8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
      9 REL="HOME"
     10 TITLE="Video for Linux Two API Specification"
     11 HREF="book1.htm"><LINK
     12 REL="UP"
     13 TITLE="Function Reference"
     14 HREF="r7624.htm"><LINK
     15 REL="PREVIOUS"
     16 TITLE="Function Reference"
     17 HREF="r7624.htm"><LINK
     18 REL="NEXT"
     19 TITLE="V4L2 ioctl()"
     20 HREF="r7667.htm"></HEAD
     21 ><BODY
     22 CLASS="REFENTRY"
     23 BGCOLOR="#FFFFFF"
     24 TEXT="#000000"
     25 LINK="#0000FF"
     26 VLINK="#840084"
     27 ALINK="#0000FF"
     28 ><DIV
     29 CLASS="NAVHEADER"
     30 ><TABLE
     31 SUMMARY="Header navigation table"
     32 WIDTH="100%"
     33 BORDER="0"
     34 CELLPADDING="0"
     35 CELLSPACING="0"
     36 ><TR
     37 ><TH
     38 COLSPAN="3"
     39 ALIGN="center"
     40 >Video for Linux Two API Specification: Revision 0.24</TH
     41 ></TR
     42 ><TR
     43 ><TD
     44 WIDTH="10%"
     45 ALIGN="left"
     46 VALIGN="bottom"
     47 ><A
     48 HREF="r7624.htm"
     49 ACCESSKEY="P"
     50 >Prev</A
     51 ></TD
     52 ><TD
     53 WIDTH="80%"
     54 ALIGN="center"
     55 VALIGN="bottom"
     56 ></TD
     57 ><TD
     58 WIDTH="10%"
     59 ALIGN="right"
     60 VALIGN="bottom"
     61 ><A
     62 HREF="r7667.htm"
     63 ACCESSKEY="N"
     64 >Next</A
     65 ></TD
     66 ></TR
     67 ></TABLE
     68 ><HR
     69 ALIGN="LEFT"
     70 WIDTH="100%"></DIV
     71 ><H1
     72 ><A
     73 NAME="FUNC-CLOSE"
     74 ></A
     75 >V4L2 close()</H1
     76 ><DIV
     77 CLASS="REFNAMEDIV"
     78 ><A
     79 NAME="AEN7630"
     80 ></A
     81 ><H2
     82 >Name</H2
     83 >v4l2-close&nbsp;--&nbsp;Close a V4L2 device</DIV
     84 ><DIV
     85 CLASS="REFSYNOPSISDIV"
     86 ><A
     87 NAME="AEN7633"
     88 ></A
     89 ><H2
     90 >Synopsis</H2
     91 ><DIV
     92 CLASS="FUNCSYNOPSIS"
     93 ><P
     94 ></P
     95 ><A
     96 NAME="AEN7634"
     97 ></A
     98 ><PRE
     99 CLASS="FUNCSYNOPSISINFO"
    100 >#include &lt;unistd.h&gt;</PRE
    101 ><P
    102 ><CODE
    103 ><CODE
    104 CLASS="FUNCDEF"
    105 >int close</CODE
    106 >(int fd);</CODE
    107 ></P
    108 ><P
    109 ></P
    110 ></DIV
    111 ></DIV
    112 ><DIV
    113 CLASS="REFSECT1"
    114 ><A
    115 NAME="AEN7641"
    116 ></A
    117 ><H2
    118 >Arguments</H2
    119 ><P
    120 ></P
    121 ><DIV
    122 CLASS="VARIABLELIST"
    123 ><DL
    124 ><DT
    125 ><CODE
    126 CLASS="PARAMETER"
    127 >fd</CODE
    128 ></DT
    129 ><DD
    130 ><P
    131 >File descriptor returned by <A
    132 HREF="r14090.htm"
    133 ><CODE
    134 CLASS="FUNCTION"
    135 >open()</CODE
    136 ></A
    137 >.</P
    138 ></DD
    139 ></DL
    140 ></DIV
    141 ></DIV
    142 ><DIV
    143 CLASS="REFSECT1"
    144 ><A
    145 NAME="AEN7651"
    146 ></A
    147 ><H2
    148 >Description</H2
    149 ><P
    150 >Closes the device. Any I/O in progress is terminated and
    151 resources associated with the file descriptor are freed. However data
    152 format parameters, current input or output, control values or other
    153 properties remain unchanged.</P
    154 ></DIV
    155 ><DIV
    156 CLASS="REFSECT1"
    157 ><A
    158 NAME="AEN7654"
    159 ></A
    160 ><H2
    161 >Return Value</H2
    162 ><P
    163 >The function returns <SPAN
    164 CLASS="RETURNVALUE"
    165 >0</SPAN
    166 > on
    167 success, <SPAN
    168 CLASS="RETURNVALUE"
    169 >-1</SPAN
    170 > on failure and the
    171 <CODE
    172 CLASS="VARNAME"
    173 >errno</CODE
    174 > is set appropriately. Possible error
    175 codes:</P
    176 ><P
    177 ></P
    178 ><DIV
    179 CLASS="VARIABLELIST"
    180 ><DL
    181 ><DT
    182 ><SPAN
    183 CLASS="ERRORCODE"
    184 >EBADF</SPAN
    185 ></DT
    186 ><DD
    187 ><P
    188 ><CODE
    189 CLASS="PARAMETER"
    190 >fd</CODE
    191 > is not a valid open file
    192 descriptor.</P
    193 ></DD
    194 ></DL
    195 ></DIV
    196 ></DIV
    197 ><DIV
    198 CLASS="NAVFOOTER"
    199 ><HR
    200 ALIGN="LEFT"
    201 WIDTH="100%"><TABLE
    202 SUMMARY="Footer navigation table"
    203 WIDTH="100%"
    204 BORDER="0"
    205 CELLPADDING="0"
    206 CELLSPACING="0"
    207 ><TR
    208 ><TD
    209 WIDTH="33%"
    210 ALIGN="left"
    211 VALIGN="top"
    212 ><A
    213 HREF="r7624.htm"
    214 ACCESSKEY="P"
    215 >Prev</A
    216 ></TD
    217 ><TD
    218 WIDTH="34%"
    219 ALIGN="center"
    220 VALIGN="top"
    221 ><A
    222 HREF="book1.htm"
    223 ACCESSKEY="H"
    224 >Home</A
    225 ></TD
    226 ><TD
    227 WIDTH="33%"
    228 ALIGN="right"
    229 VALIGN="top"
    230 ><A
    231 HREF="r7667.htm"
    232 ACCESSKEY="N"
    233 >Next</A
    234 ></TD
    235 ></TR
    236 ><TR
    237 ><TD
    238 WIDTH="33%"
    239 ALIGN="left"
    240 VALIGN="top"
    241 >Function Reference</TD
    242 ><TD
    243 WIDTH="34%"
    244 ALIGN="center"
    245 VALIGN="top"
    246 ><A
    247 HREF="r7624.htm"
    248 ACCESSKEY="U"
    249 >Up</A
    250 ></TD
    251 ><TD
    252 WIDTH="33%"
    253 ALIGN="right"
    254 VALIGN="top"
    255 >V4L2 ioctl()</TD
    256 ></TR
    257 ></TABLE
    258 ></DIV
    259 ></BODY
    260 ></HTML
    261 >
    262