1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>CAMERA_SwitchOffLED*</TITLE>
8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">CAMERA_SwitchOffLED* <IMG src="../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13<DL>
14  <DD>
15<CODE>#include &lt;twl/camera.h&gt;</CODE><BR> <BR> <CODE><A href="CAMERAResult.html">CAMERAResult</A> CAMERA_SwitchOffLED(void);</CODE> <BR> <CODE><A href="CAMERAResult.html">CAMERAResult</A> CAMERA_SwitchOffLEDAsync(<A href="CAMERACallback.html">CAMERACallback</A> callback, void *arg);</CODE>
16</DL>
17<H2>Arguments</H2>
18<TABLE border="1" width="100%">
19  <TBODY>
20    <TR>
21<TD width="13%"><EM><STRONG>callback</STRONG></EM></TD>
22<TD width="87%">Function that is called when asynchronous processing has completed.</TD>
23    </TR>
24    <TR>
25<TD width="13%"><EM><STRONG>arg</STRONG></EM></TD>
26<TD width="87%">Arguments when the callback function is invoked.</TD>
27    </TR>
28  </TBODY>
29</TABLE>
30
31<H2>Return Values</H2>
32<P>
33Returns <CODE>CAMERA_RESULT_SUCCESS</CODE> if configuration was successful.
34</P>
35
36<H2>Description</H2>
37<P>
38Turns off the outer camera indicator LED for the duration of a single blink (approximately 0.8 seconds).<BR><BR>The camera indicator LED is configured to light up when the outer camera is activated. If you call this function from that state, the camera indicator LED is turned off for the duration of a single blink, as configured by the <a href="CAMERA_SetLED.html"><CODE>CAMERA_SetLED</CODE></a> function. Note that the function therefore fails if the outer camera is not active.<BR> <BR>This function behaves the same as calling <a href="CAMERA_SetLED.html"><CODE>CAMERA_SetLED(TRUE)</CODE></a>, waiting 6 ms, and then calling <a href="CAMERA_SetLED.html"><CODE>CAMERA_SetLED(FALSE)</CODE></a>.<br><br> <B>Note:</B> For this reason, the synchronous version of this function blocks execution internally for 6 ms after it is called.<br> When the asynchronous version is called, execution returns immediately without being blocked, but note that you cannot use other <CODE>CAMERA</CODE> functions during the 6 ms after calling the function.<br> <br>If these restrictions are confusing, you can use a separate <a href="CAMERA_SetLED.html"><CODE>CAMERA_SetLED</CODE></a> call to turn off the LED.
39</P>
40
41<H2>See Also</H2>
42<P><CODE><A href="CAMERA_SetLED.html">CAMERA_SetLED*</A></CODE></P>
43<H2>Revision History</H2>
44<P>
452009/06/08 Explained the time it takes to blink.<br> 2009/04/15 Added text about the restrictions on calling this function.<br> 2008/09/09 Initial version
46</P>
47<hr><p>CONFIDENTIAL</p></body>
48</HTML>
49