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_CreateFileFromRom</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">FS_CreateFileFromRom <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_CreateFileFromRom(<A href="../fs_file_type.html">FSFile</A> *p_file, u32 offset, 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_file</STRONG></EM></TD>
30      <TD width="87%">Address of the <A href="../fs_file_type.html"><CODE>FSFile</CODE></A> structure.</TD>
31    </TR>
32    <TR>
33      <TD width="13%"><EM><STRONG>offset</STRONG></EM></TD>
34      <TD width="87%">Offset for start of CARD-ROM region for the read.</TD>
35    </TR>
36    <TR>
37      <TD width="13%"><EM><STRONG>size</STRONG></EM></TD>
38      <TD width="87%">Byte size of the target region from the offset.</TD>
39    </TR>
40  </TBODY>
41</TABLE>
42
43<h2>Return Values</h2>
44<p>TRUE if the file opens properly. FALSE otherwise.</p>
45
46<H2>Description</H2>
47<P>Treats the specified CARD-ROM region as a temporary file and opens the file. The file opened by this function supports only these following functions: <code>
48<ul>
49<li><A href="FS_SeekFile.html">FS_SeekFile()</A>, <A href="FS_SeekFileToBegin.html">FS_SeekFileToBegin()</A>, <A href="FS_SeekFileToEnd.html">FS_SeekFileToEnd()</A>
50<li><A href="FS_ReadFile.html">FS_ReadFile()</A>
51<li><A href="FS_ReadFileAsync.html">FS_ReadFileAsync()</A>
52<li><A href="FS_CloseFile.html">FS_CloseFile()</A>
53</ul>
54</code>
55</P>
56<P>
57For further information, see the explanation for the <A href="../archive_rom_spec.html"><CODE>ROM Archive</CODE></a> function.
58</P>
59<H2>Note</H2>
60<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>
61<BR>
62<h2>See Also</h2>
63<p><CODE><A href="../fs_file_type.html">FSFile</A> <A href="../fs_archive_type.html">FSArchive</A> <A href="../archive_rom_spec.html">ROM Archive</a></CODE></p>
64
65<H2>Revision History</H2>
66<P>
672005/06/28 Initial version.
68</P>
69<hr><p>CONFIDENTIAL</p></body>
70</html>
71