1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml"> 3 <head> 4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 5 <meta http-equiv="Content-Style-Type" content="text/css" /> 6 <link rel="stylesheet" href="../../../css/manpage.css" type="text/css" /> 7 <title>GetBufferErrorInterruptEvent</title> 8 </head> 9 <body> 10 <h1><CODE><a href="../../../nn/Overview.html">nn</a>::<a href="../../../nn/camera/Overview.html">camera</a>::<a href="../../../nn/camera/CTR/Overview.html">CTR</a>::GetBufferErrorInterruptEvent</CODE> Function</h1> 11 <h2>Syntax</h2> 12 <div class="section"> 13 <pre class="definition"> 14void GetBufferErrorInterruptEvent( 15 <a href="../../../nn/os/Event/Overview.html">nn::os::Event</a> * pEvent, 16 <a href="../../../nn/camera/CTR/Port.html">Port</a> port 17); 18</pre> 19 </div> 20 <h2>Parameters</h2> 21 <div class="section"> 22 <table class="arguments"> 23 <thead> 24 <tr> 25 <td width="15" /> 26 <th>Name</th> 27 <td>Description</td> 28 </tr> 29 </thead> 30 <tr> 31 <td>out</td> 32 <th>pEvent</th> 33<td>Event to signal when a buffer error or reboot occurs.</td> 34 </tr> 35 <tr> 36 <td>in</td> 37 <th>port</th> 38 <td>Specifies port on which to detect interrupts.</td> 39 </tr> </table> 40 </div> 41 <h2>Return Values</h2> 42 <div class="section"> 43 None. 44 </div> 45 <h2>Description</h2> 46 <div class="section"> 47 <p>Gets the event used to detect camera buffer error interrupts and reboots.</p><p>Reboot notifications occur for both <CODE>PORT_CAM1</CODE> and <CODE>PORT_CAM2</CODE>.</p><p> 48 This function gets an auto-reset event in <SPAN class="argument">pEvent</SPAN> regardless of how the application was initialized. 49 </p><p> 50 When the camera data transfer does not happen in time and the SoC buffer overflows, camera image data is not retrieved and the <CODE>pEvent</CODE> obtained by this function is in the signaled state. In such a case, the SoC buffer is cleared by the camera library. Upon detecting the signaled state, reconfigure the transfer with the <CODE><a href="../../../nn/camera/CTR/SetReceiving.html">nn::camera::CTR::SetReceiving</a></CODE> function and resume data retrieval with the <CODE><a href="../../../nn/camera/CTR/StartCapture.html">nn::camera::CTR::StartCapture</a></CODE> function. 51 </p><p> 52 The camera may also behave abnormally following a large static electricity shock. When the camera library detects abnormal operation, it resets and reboots the camera, and restores the previous settings. Recovery halts image data retrieval from the camera and clears the SoC buffer, after which the <CODE>pEvent</CODE> obtained by this function is in the signaled state. Upon detecting the signaled state, reconfigure the transfer with the <CODE>SetReceiving</CODE> function and resume data retrieval with the <CODE><a href="../../../nn/camera/CTR/StartCapture.html">nn::camera::CTR::StartCapture</a></CODE> function. 53 </p><p> 54 For either buffer overflows or reboots, the SoC buffer state is the same following the signal of the <CODE>pEvent</CODE> obtained by this function, so there is no need for the application to implement any special handling code. 55 </p></div> 56 <h2>Revision History</h2> 57 <div class="section"> 58 <dl class="history"> 59 <dt>2010/07/14</dt> 60 <dd>Added to description of conditions for an event to enter the signaled state. 61 </dd> 62 <dt>2010/06/17</dt> 63 <dd>Added information on event types. 64 </dd> 65 <dt>2010/01/07</dt> 66 <dd>Initial version.<br /> 67 </dd> 68 </dl> 69 </div> 70 <hr><p>CONFIDENTIAL</p></body> 71</html>