FSResult FS_ARCHIVE_PROC_FUNC(
FSFile *p_file,
FSCommandType command /* = FS_COMMAND_SEEKDIR */);
Operating specifications for the archive command FS_COMMAND_SEEKDIR are shown below:
arg.seekdir that is stored in p_file.nitro/fs/file.h as shown below:
typedef struct
{
FSDirPos pos;
} FSSeekDirInfo;
| Arguments | Content |
|---|---|
pos |
The directory position to be moved is stored in a FSDirPos type.The FS_COMMAND_READDIR command generates this value. |
p_file variable prop.dir as shown below:pos in prop.dir.pos. If both pos.index and pos.pos are 0, it signifies the top of the directory array position.FS_COMMAND_SEEKDIR and FS_COMMAND_READDIR commands. You may determine your own meanings for the pos name variables as long as they are appropriate arguments for these commands.
pos in prop.dir.parent. "pos.own_id = 0" signifies the root directory. In the case of the root directory, this sets the total number of directories into prop.dir.parent.FS_COMMAND_GETPATH commands.prop.dir.pos.arc |
Uses the arguments as-is |
prop.dir.pos.own_id |
Uses the arguments as-is |
prop.dir.pos.index |
The position at which the next FNT directory entry resides. (Conforms to NitroROM format) |
prop.dir.pos.pos |
If the next directory entry is a file, that file's index This value increments by one each time FS_COMMAND_READDIR completes successfully.(Conforms to NitroROM format) |
prop.dir.parent |
Parent directory's index, or total number of directories. (Conforms to NitroROM format) |
pos.own_id.FS_RESULT_SUCCESS, p_file becomes a handle that contains directory position information. Subsequently the FS_IsDir function returns TRUE. It can also be used as an argument in functions that operate on directories.FS_SeekDirFS_RewindDirFS_FINDPATH command)FS_ChangeDirFS_OpenFileFS_ConvertPathToFileIDFS_GetPathNameFS_GetPathLengthFSArchive, FS_ARCHIVE_PROC_FUNC, FS_COMMAND_*, FS_SetArchiveProc
07/12/2004 Initial Version