FS_LoadTable

構文

#include <nitro/fs.h>

BOOL FS_LoadTable( void *p_mem, u32 size );

引数

p_mem テーブルのためにユーザが用意するメモリへのポインタ
size メモリのバイトサイズ

返り値

テーブルのロードに成功すれば TRUE を、そうでないなら FALSE を返します。

説明

ファイルシステム内部で頻繁にアクセスされる各種テーブルのデータを
前もってメモリにすべてロードし、アクセス効率の向上を図ります。

指定したメモリサイズがテーブルを格納するのに充分であれば、
各種テーブルのデータをメモリに読み込みます。
このメモリは以降のファイルアクセスで内部的に使用されるので、
ユーザはこれを使用することができなくなります。

指定したメモリサイズが充分でない場合は、何も行いません。
この場合、指定したメモリは使われずにユーザへ返されます。

テーブルに対して充分なメモリサイズは、FS_GetTableSize()で取得することができます。

注意

この関数を割り込みハンドラ(IRQモード)から呼び出すことはできません。
また、割り込みを禁止したままの状態にあると処理が完了しない場合がある点に注意して下さい。


参照

FS_GetTableSize

履歴

2004/09/24 呼び出し時および完了の条件についての注意を記述追加
2004/04/22 初版