FS_LoadTable

Syntax

#include <nitro/fs.h>

BOOL FS_LoadTable( void *p_mem, u32 size );

Arguments

p_mem Pointer to the memory that a user prepares for tables
size Memory size in bytes

Return Values

Returns TRUE if table load succeeds; FALSE otherwise.

Description

This function increases access efficiency by preloading all of the data in the tables that the file system frequently accesses internally into memory. If the specified memory size is sufficient to hold the tables, this function will load all of the table data into memory. This memory will be used internally for subsequent file access. Therefore, users will not be able to use it.
This function will not perform any action if the specified memory size is insufficient.
In such a situation, the specified memory will not be used and will be returned to the user.
To obtain a sufficient memory size for the tables, use the FS_GetTableSize function.

Note

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

FS_GetTableSize

Revision History

2004/09/24 Added the description in the Caution section regarding the conditions for calling this function.
2004/04/22 Initial version.


CONFIDENTIAL