FS_OpenFileFast

C Specification

#include <nitro/fs.h>

BOOL FS_OpenFileFast( FSFile *p_file, FSFileID file_id );

Arguments

p_file Address of the FSFile structure
file_id File ID that is specified by file_id in the FSDirEntry structure.

Return Values

TRUE if the file opens properly. FALSE otherwise.

Description

This function uses the specified ID to open a file. Use the FS_ReadDir function to obtain the ID.

Note

In the application, the NITRO_MAKEROM flag must be enabled so that the ROM file system is included.
This function cannot be called from the interrupt handler (IRQ mode).
Also note that in some cases processing may not end if interrupts are left prohibited.

See Also

FSFileID, FSFile, FS_OpenFile, FS_CloseFile, FS_GetLength, FS_ReadFile, FS_SeekFile, FS_SeekFileToBegin, FS_SeekFileToEnd, FS_ReadDir, FSDirEntry

Revision History

11/02/2004 Changed the argument name.
09/24/2004 Added text under Caution regarding the conditions for calling this function.
05/14/2004 ID type changed from u32 to FSFileID.
04/02/2004 File system -> ROM file system.
04/01/2004 Initial version.