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_OpenFileDirect</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">FS_OpenFileDirect <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_OpenFileDirect(<A href="../fs_file_type.html">FSFile</a> *p_file, <A href="../fs_archive_type.html">FSArchive</a> *p_arc,
22	u32 image_top, u32 image_bottom, u32 file_index);</CODE><br>
23  <br>
24  </dd>
25</dl>
26<h2>Arguments</h2>
27<TABLE border="1" width="100%">
28  <TBODY>
29    <TR>
30<TD width="13%"><SPAN class="argument">p_file</SPAN></TD>
31<TD width="87%">Address of the <A href="../fs_file_type.html"><CODE>FSFile</CODE></A> structure.</TD>
32    </TR>
33    <TR>
34<TD width="13%"><SPAN class="argument">p_arc</SPAN></TD>
35<TD width="87%">Address of the <a href="../fs_file_type.html"><CODE>FSArchive</CODE></a> structure to be associated</TD>
36    </TR>
37    <TR>
38<TD width="13%"><SPAN class="argument">image_top</SPAN></TD>
39<TD width="87%">Offset for the beginning of the file region (memory space) specified by <code>p_arc</code></TD>
40    </TR>
41    <TR>
42<TD width="13%"><SPAN class="argument">image_bottom</SPAN></TD>
43<TD width="87%">Offset for the end of the file region (memory space) specified by <code>p_arc</code></TD>
44    </TR>
45    <TR>
46<TD width="13%"><SPAN class="argument">file_index</SPAN></TD>
47<TD width="87%">Index value to be allocated to the file</TD>
48    </TR>
49  </TBODY>
50</TABLE>
51
52<h2>Return Values</h2>
53<p><CODE>TRUE</CODE> if the file opens properly; <CODE>FALSE</CODE> otherwise.</p>
54
55<H2>Description</H2>
56<ul>
57<li style='color:Red;'>
58This 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.</li>
59<li style='color:Red;'>Because the structures of opened files are linked with system resources, you cannot move or duplicate the information in these structures by copying them into other structures. For details, see the <a href="../fs_file_type.html"><CODE>FSFile</CODE></a> structure.</li>
60</ul>
61
62<H2>Note</H2>
63<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>
64<BR>
65<h2>See Also</h2>
66<p><a href="../fs_file_type.html"><code>FSFile</code></a><BR> <a href="../fs_archive_type.html"><code>FSArchive</code></a><BR> <a href="FS_GetFileImageTop.html"><code>FS_GetFileImageTop</code></a><BR> <a href="FS_GetFileImageBottom.html"><code>FS_GetFileImageBottom</code></a></p>
67
68<H2>Revision History</H2>
69<P>
702009/07/29 Added mention that copying structure values is not guaranteed.<br />
71 2004/09/24 Added description in <B>Note</B> regarding the conditions for calling this function.<br> 2004/07/13 Initial version.</P>
72<hr><p>CONFIDENTIAL</p></body>
73</html>
74