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_LoadArchiveTables</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">FS_LoadArchiveTables <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>u32	FS_LoadArchiveTables(<A href="../fs_archive_type.html">FSArchive</a> *p_arc, void *p_mem, u32 max_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><code><EM><STRONG>p_arc</STRONG></EM></code></STRONG></EM></TD>
30      <TD width="87%">Address of the <A href="../fs_archive_type.html"><code>FSArchive</code></a> structure.</TD>
31    </TR>
32    <TR>
33      <TD width="13%"><EM><STRONG>p_mem</STRONG></EM></TD>
34      <TD width="87%">Pointer to the memory that a user prepares for tables.</TD>
35    </TR>
36    <TR>
37      <TD width="13%"><EM><STRONG>max_size</STRONG></EM></TD>
38      <TD width="87%">Memory size in bytes</TD>
39    </TR>
40  </TBODY>
41</TABLE>
42
43<h2>Return Values</h2>
44<p>The exact number of bytes needed to load the tables.</p>
45
46<H2>Description</H2>
47<P>This function loads the archive's FAT and FNT information table data into previously obtained memory. Doing this boosts the access efficiency of commands that involve directory operations. If 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> <BR> This function always returns the number of bytes that are required to load the tables.<BR> The judgment is based on whether the returned value is larger than <code>max_size</code> or equal to or smaller than <code>max_size</code>.<BR> <BR> <BR>
48</P>
49<h2>See Also</h2>
50<p><CODE></CODE></p>
51
52<H2>Revision History</H2>
53<P>
542004/11/02 Made argument names consistent.<br> 2004/06/30 Initial version.
55</P>
56<hr><p>CONFIDENTIAL</p></body>
57</html>
58