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_LoadSharedFont</TITLE>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11
12<H1 align="left">NA_LoadSharedFont <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_LoadSharedFont( <a href="NASharedFontIndex.html">NASharedFontIndex</a> index, void *pBuffer );</CODE></PRE>
19</DL>
20
21<H2>Arguments</H2>
22<TABLE border="1" width="100%">
23  <TBODY>
24    <TR>
25      <TD width="13%"><EM><STRONG>index</STRONG></EM></TD>
26      <TD width="87%">Index that specifies the internal font to load.</TD>
27    </TR>
28    <TR>
29      <TD width="13%"><EM><STRONG>pBuffer</STRONG></EM></TD>
30      <TD width="87%">Pointer to the buffer in which the internal font will be loaded.</TD>
31    </TR>
32  </TBODY>
33</TABLE>
34
35<H2>Return Values</H2>
36<P>
37Returns <CODE>TRUE</CODE> if processing completed successfully.<BR>The following are possible reasons for the function to fail.
38</P>
39<ul>
40<li>The <a href="NA_InitSharedFont.html"><code>NA_InitSharedFont</code></a> function has not been called.
41<li>The <a href="NA_LoadSharedFontTable.html"><code>NA_LoadSharedFontTable</code></a> function has not been called.
42<li>The <span class="argument">index</span> is an illegal value.
43<li>The application is not a NAND application.
44<li>There are no available file handles because they are all in use.
45<li>It is running on the Nintendo DS.
46</ul>
47
48<H2>Description</H2>
49<P>
50Loads an internal font into memory. You must call the <a href="NA_LoadSharedFontTable.html"><code>NA_LoadSharedFontTable</code></a> function before this one.
51</P>
52<P>
53The buffer size passed to <span class="argument">pBuffer</span> must be the value obtained from the <a href="NA_GetSharedFontSize.html"><code>NA_GetSharedFontSize</code></a> function. You can release <span class="argument">pBuffer</span> when you no longer need the font.
54</P>
55<P>
56This function is exclusive to NAND applications. It cannot be used by card applications.
57</P>
58
59<H2>See Also</H2>
60<P>
61</P>
62
63<H2>Revision History</H2>
64<P>
652008/09/16 Initial version.
66</P>
67
68<hr><p>CONFIDENTIAL</p></body>
69</HTML>