Shinobi Library - ファイルシステム関数

gdFsLoadDir

ディレクトリレコードの読み込み

書式

Sint32 gdFsLoadDir( dirname, gf_dirrec )
const char *dirname
GDFS_DIRREC gf_dirrec

引数

dirname   ディレクトリ名
gf_dirrec   ディレクトリレコードハンドル

戻り値

GDD_ERR_OK   正常終了
GDD_ERR_NOTFOUND   ファイルが見つからない
GDD_ERR_NOTDIR   ディレクトリでないものを指定した
GDD_ERR_DIROVER   ディレクトリエントリ最大数をオーバーした
GDD_ERR_BUSY   他のコマンドを実行中
GDD_ERR_TOUT   ドライブから応答がない(20秒間応答が無い)
GDD_ERR_NOERR   報告すべきエラーはない
GDD_ERR_RECOVER   エラーを回復した
GDD_ERR_NOTREADY   メディアは認識中か未装着
GDD_ERR_MEDIA   メディアが不良
GDD_ERR_HWARE   ハードウェアの劣化等
GDD_ERR_UNITATTENT   メディアの交換を検出
GDD_ERR_TRAYOPEND   ディスクドアがオープンされている
GDD_ERR_CHECKBUSY   メディア認識中のため BUSY

解説

ディレクトリレコードを読み込みます。

引数 gf_dirrecにNULLを指定した場合は、カレントディレクトリのディレクトリレコードを読み込みます。


用例

/* Sample 1 */
/* Load MOVIE directory into g_dir */
Uint32 dirbuf[gdFsGetDirrecSize(64)];
GDFS_DIRREC g_dir;
g_dir = gdFsCreateDirhn(dirbuf, 64);
gdFsLoadDir("MOVIE", g_dir);
/* Sample 2 */
/* Change the current directory to the DATA directory */
gdFsLoadDir("DATA", NULL);

備考

この関数は完了復帰関数です。割り込み禁止区間内で実行するとタイムアウトできなくなります。

大文字と小文字は同一に扱います。

この関数はドライブに実際にアクセスする関数です。


参照

GDD_ERR
 GDファイルシステムエラー

gdFsLoadDir
COPYRIGHT © SEGA ENTERPRISES, LTD., 1998-2000