FS_OpenFileFast


C Specification

#include <nitro/fs.h>

BOOL FS_OpenFileFast( FSFile *p_file, FSFileID file_id );
    

Description

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

Caution

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). Note that the process may not be completed if interrupts are prohibited.

Arguments

p_file The FSFile structure's address
file_id File ID that is specified by file_id in the FSDirEntry structure.

Return Values

If the file is correctly opened, it returns a value of TRUE. Otherwise it returns a value of FALSE.

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.