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=windows-1252">
6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>FS_LoadTable</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">FS_LoadTable <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;nitro/fs.h&gt;</CODE><BR>
20  <BR>
21  <CODE>BOOL FS_LoadTable( void *p_mem, u32 size );</CODE><br>
22  <br>
23  </dd>
24</dl>
25<h2>Arguments</h2>
26<TABLE border="1" width="100%">
27  <TBODY>
28    <TR>
29      <TD width="13%"><EM><STRONG>p_mem</STRONG></EM></TD>
30      <TD width="87%">Pointer to the memory that a user prepares for tables</TD>
31    </TR>
32    <TR>
33      <TD width="13%"><EM><STRONG>size</STRONG></EM></TD>
34      <TD width="87%">Memory size in bytes</TD>
35    </TR>
36  </TBODY>
37</TABLE>
38
39<h2>Return Values</h2>
40<p>Returns TRUE if table load succeeds; FALSE otherwise.</p>
41
42<H2>Description</H2>
43<P>This function increases access efficiency by preloading all of the data in the tables that the file system frequently accesses internally into memory.
44
45If the specified memory size is sufficient to hold the tables, this function will load all of the table data into memory. This memory will be used internally for subsequent file access. Therefore, users will not be able to use it.<BR> This function will not perform any action if the specified memory size is insufficient.<BR> In such a situation, the specified memory will not be used and will be returned to the user.<BR> To obtain a sufficient memory size for the tables, use the <code><A href="FS_GetTableSize.html">FS_GetTableSize</A></code> function. <BR>
46</P>
47<H2>Note</H2>
48<p><font color="#800000">This function cannot be called from the interrupt handler (IRQ mode).<br> Also note that in some cases processing may not end if interrupts are left prohibited.<br></font></p>
49<BR><h2>See Also</h2>
50<p><CODE><A href="FS_GetTableSize.html">FS_GetTableSize</A></CODE></p>
51
52<H2>Revision History</H2>
53<P>
542004/09/24 Added the description in the Caution section regarding the conditions for calling this function.<br> 2004/04/22 Initial version.
55</P>
56<hr><p>CONFIDENTIAL</p></body>
57</html>
58