1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=utf-8">
6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 6.5.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
9<title>NANDSetAutoErrorMessaging</title>
10</head>
11
12<body>
13
14<h1>NANDSetAutoErrorMessaging</h1>
15
16<h2>Syntax</h2>
17<dl><dd><pre class="construction">
18#include &lt;revolution/nand.h&gt;
19
20BOOL NANDSetAutoErrorMessaging(BOOL enable);
21</pre></dd></dl>
22
23<h2>Arguments</h2>
24<TABLE class="arguments" border="1" >
25  <tr>
26      <TH>enable</TH>
27      <TD><CODE>TRUE</CODE> (the default setting) enables Auto Error Message mode. <CODE>FALSE</CODE> disables this mode.</TD>
28    </tr>
29</TABLE>
30
31<h2>Return Values</h2>
32<P>Returns <CODE>TRUE</CODE> if Auto Error Message mode is enabled and <CODE>FALSE</CODE> if it is disabled.</P>
33
34<h2>Description</h2>
35<P>Changes the Auto Error Message mode.</P>
36<P>When this mode is enabled, the NAND flash device driver processes some result codes (see below). When an error occurs, it displays the appropriate error message on the TV screen and immediately disconnects by calling the <code><a href="../os/Error/OSFatal.html">OSFatal</a></code> function. During this time, no application code can execute. In other words, developers do not need to worry about responding to the result codes shown below.</P>
37<P>Depending on the system's language setting, the appropriate error message is selected from one of seven languages (English, Japanese, German, French, Spanish, Italian, or Dutch).</P>
38<P>
39Developers who plan to implement their own FATAL error message must call <CODE>NANDSetAutoErrorMessaging(FALSE)</CODE> at the start of their applications.</P>
40<P>This function automatically displays the error messages corresponding to the following result codes.
41<ul>
42<li><code>NAND_RESULT_MAXBLOCKS</code>
43<li><code>NAND_RESULT_MAXFILES</code>
44<li><code>NAND_RESULT_CORRUPT</code>
45<li><code>NAND_RESULT_BUSY</code>
46<li><code>NAND_RESULT_ALLOC_FAILED</code>
47<li><code>NAND_RESULT_UNKNOWN</code>
48</ul>
49</P>
50<P>
51<font color="red"><b>Note that the application is still responsible for displaying messages for other result codes (for example, <CODE>NAND_RESULT_ECC_CRIT</CODE>).</b></font>
52</P>
53
54<h2>See Also</h2>
55<p class="reference">
56<a href="../os/Error/OSFatal.html">OSFatal</a>
57</p>
58
59<H2>Revision History</H2>
60<P>
612009/07/24 Initial version.
62</P>
63
64<hr><p>CONFIDENTIAL</p></body>
65</html>