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>NA_SaveSubBanner</TITLE>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11
12<H1 align="left">NA_SaveSubBanner <IMG src="../../image/BPT.gif" align=middle><IMG src="../../image/TWL.gif" align=middle></H1>
13
14<H2>Syntax</H2>
15<DL>
16  <DD>
17  <PRE><CODE>#include &lt;twl/na.h&gt;</CODE></PRE>
18  <PRE><CODE>BOOL NA_SaveSubBanner( const NASubBanner *banner );</CODE></PRE>
19</DL>
20
21<H2>Arguments</H2>
22<TABLE border="1" width="100%">
23  <TBODY>
24    <TR>
25      <TD width="13%"><span class="argument">banner</span></TD>
26      <TD width="87%">Pointer to the buffer with the sub-banner to set.</TD>
27    </TR>
28  </TBODY>
29</TABLE>
30
31<H2>Return Values</H2>
32<P>
33Returns <CODE>TRUE</CODE> if processing completed successfully.<BR> The following are possible reasons for the function to fail.
34</P>
35<ul>
36<li>The <CODE>crc16_anime</CODE> member in <span class="argument">banner</span> is illegal.
37<li>The <CODE>anime</CODE> member in <span class="argument">banner</span> is illegal.
38<li>The application is not a NAND application.
39<li>The application has not declared the sub-banner specifications.
40<li>There are no available file handles because they are all in use.
41<li>It is running on the Nintendo DS.
42</ul>
43
44<H2>Description</H2>
45<P>
46Replaces the sub-banner with the specified sub-banner data so that the launcher displays the sub-banner.
47</P>
48<P>
49This function is exclusive to NAND applications. It cannot be used by card applications.
50</P>
51<P>
52The DEBUG version outputs a warning message if the <CODE>anime</CODE> member in <span class="argument">banner</span> is illegal. See <A href="NASubBanner.html"><CODE>NASubBanner</CODE></A> and the information that is output to make revisions.
53</P>
54<H2>See Also</H2>
55<P>
56<A href="NA_LoadSubBanner.html"><CODE>NA_LoadSubBanner</CODE></A><BR> <A href="NASubBanner.html"><CODE>NASubBanner</CODE></A>
57</P>
58
59<H2>Revision History</H2>
60<P>
612008/11/04 Added information on animation errors. <BR>2008/09/16 Initial version.
62</P>
63
64<hr><p>CONFIDENTIAL</p></body>
65</HTML>