TCL_LoadTable

定義

#include <twl/tcl.h>

TCLResult TCL_LoadTable( TCLAccessor* pAccessor ,
                         void* tableBuffer ,
                         u32 tableBufferSize ,
                         void* workBuffer ,
                         u32 workBufferSize ,
                         FSResult* pFSResult );
	

引数

pAccessor	アクセサ
tableBuffer	管理ファイル読み込みバッファ
tableBufferSize	管理ファイル読み込みバッファサイズ
workBuffer	ワークバッファ
workBufferSize	ワークバッファサイズ
pFSResult	関数内部で各種FS関数にエラーが発生した場合の処理結果

返り値

処理結果

説明

管理ファイルを読み込みます。

tableBuffer と tableBufferSize にはそれぞれ、TCL_GetTableBufferSize で表されるサイズのバッファとバッファサイズを指定して下さい。

workBuffer と workBufferSize にはそれぞれ、TCL_GetWorkBufferSize で表されるサイズのバッファとバッファサイズを指定して下さい。

この関数の返り値と可能な処理の対応は

TCL_RESULT_SUCCESS	読み込み、書き出し処理共に可能
TCL_RESULT_ERROR_EXIST_OTHER_FILE TCL_RESULT_ERROR_ALREADY_MANAGED	読み込み処理可能、書き出し処理不可
その他	読み込み、書き出し処理共に不可

となります。

写真の読み込みのみ(書き出し処理は行わない)の場合は TCL_RESULT_ERROR_EXIST_OTHER_FILE や TCL_RESULT_ERROR_ALREADY_MANAGED が返って来ても処理を続けることが可能です。

写真の書き出し処理を行う場合で、上記2つのエラーが返って来た場合、TCL_RepairTable を使用して書き出し可能な状態にする必要があります。

それ以外のエラーが返って来た場合、読み込み、書き出し処理共に不可となるため、TCL_CreateTable を使用して管理ファイルを生成しなおす必要があります。

参照

TCL_RepairTable TCL_CreateTable

履歴

2008/10/07 初版