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_OpenFileFast</title> 9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css"> 10</head> 11 12<body> 13 14<h1 align="left">FS_OpenFileFast <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 <nitro/fs.h></CODE><BR> 20 <BR> 21 <CODE>BOOL FS_OpenFileFast( <A href="../fs_file_type.html">FSFile</a> *p_file, <A href="../fs_file_id_type.html">FSFileID</a> file_id );</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%"><SPAN class="argument">p_file</SPAN></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%"><SPAN class="argument">file_id</SPAN></TD> 34<TD width="87%">File ID specified by <CODE>file_id</CODE> in the <A href="../fs_dir_entry_type.html"><CODE>FSDirEntry</CODE></a> structure</TD> 35 </TR> 36 </TBODY> 37</TABLE> 38 39<h2>Return Values</h2> 40<p><CODE>TRUE</CODE> if the file opens properly; <CODE>FALSE</CODE> otherwise.</p> 41 42<H2>Description</H2> 43<P>Uses the specified ID to open a file. Use the <A href="FS_ReadDir.html"><CODE>FS_ReadDir</CODE></A> function to get the ID. When using the <A href="../directory/FS_ReadDirectory.html"><CODE>FS_ReadDirectory</CODE></A> function, the obtained ID (<A href="../FSDirectoryEntryInfo.html"><CODE>FSDirectoryEntryInfo.id</CODE></A>) format is not a <A href="../fs_file_type.html"><CODE>FSFile</CODE></a> structure, so you must directly set <SPAN class="argument">arc</SPAN> and <SPAN class="argument">file_id</SPAN> using the separately prepared <A href="../fs_file_type.html"><CODE>FSFile</CODE></a> structure.<BR> 44</P> 45<h2>Note</h2> 46<ul> 47<li style='color:Red;'> 48This 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> 49<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> 50</ul> 51 52<h2>See Also</h2> 53<p><A href="../fs_file_id_type.html"><CODE>FSFileID</CODE></A><BR> <A href="../fs_file_type.html"><CODE>FSFile</CODE></A><BR> <A href="FS_OpenFileEx.html"><CODE>FS_OpenFileEx</CODE></A><BR> <A href="FS_CloseFile.html"><CODE>FS_CloseFile</CODE></A><BR> <A href="FS_GetFileLength.html"><CODE>FS_GetFileLength</CODE></A><BR> <A href="FS_ReadFile.html"><CODE>FS_ReadFile</CODE></A><BR> <A href="FS_SeekFile.html"><CODE>FS_SeekFile</CODE></A><BR> <A href="FS_SeekFileToBegin.html"><CODE>FS_SeekFileToBegin</CODE></A><BR> <A href="FS_SeekFileToEnd.html"><CODE>FS_SeekFileToEnd</CODE></A><BR> <A href="FS_ReadDir.html"><CODE>FS_ReadDir</CODE></A><BR> <A href="../fs_dir_entry_type.html"><CODE>FSDirEntry</CODE></A><BR> <A href="../directory/FS_ReadDirectory.html"><CODE>FS_ReadDirectory</CODE></A><BR> <A href="../FSDirectoryEntryInfo.html"><CODE>FSDirectoryEntryInfo</CODE></A></p> 54 55<H2>Revision History</H2> 56<P> 572009/07/29 Added mention that copying structure values is not guaranteed.<br /> 2009/07/16 Added description of restriction applied when using <CODE>FS_ReadDirectory</CODE>.<br /> 2008/10/02 Revised <B>See Also</B>.<br /> 2004/11/02 Changed the argument name.<br /> 2004/09/24 Added text under <B>Note</B> regarding the conditions for calling this function.<br /> 2004/05/14 Changed ID type from <CODE>u32</CODE> to <CODE>FSFileID</CODE>.<br /> 2004/04/02 Changed "file system" to "ROM file system."<br /> 2004/04/01 Initial version. 58</P> 59<hr><p>CONFIDENTIAL</p></body> 60</html> 61
