FS_LoadArchiveTables

構文

#include <nitro/fs.h>

u32 FS_LoadArchiveTables(FSArchive *p_arc, void *p_mem, u32 max_size);

引数

p_arc FSArchive構造体のアドレス
p_mem テーブルのためにユーザが用意するメモリへのポインタ
max_size メモリのバイトサイズ

返り値

常に、テーブルのロードに必要なだけの充分なバイトサイズを返します。

説明

アーカイブのFAT情報およびFNT情報のテーブルデータを前もってメモリにすべてロードします。
これにより、ディレクトリ操作に関するコマンドのアクセス効率の向上を図ります。

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

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

関数は常に、テーブルのロードに必要なだけの充分なバイトサイズを返します。
この返り値がmax_sizeを上回るかmax_size以下であるかにより、格納されたかどうかが判断できます。


参照

履歴

2004/11/02 引数名の不一致を修正
2004/06/30 初版