FS_COMMAND_OPENFILEFAST


C Specification

FSResult FS_ARCHIVE_PROC_FUNC(
    FSFile          *p_file,
    FSCommandType   command /* = FS_COMMAND_OPENFILEFAST */);

Description

Operating specifications for the archive command FS_COMMAND_OPENFILEFAST are shown below:


Arguments passed to this command
This command takes (as a command argument) the variable arg.openfilefast that is stored at p_file.
This variable is defined in nitro/fs/file.h as shown below:
typedef struct
        {
            FSFileID id;
        } FSOpenFileFastInfo;

Argument content is listed below:
Arguments Content
id The ID of the file to be opened.
The FS_COMMAND_READDIR command generates this value.

Actions required of this command
It sets the p_file variable prop.file as shown below:

Default Implementation
The command sets values based on the following determinants:
prop.file.top The area top position that is acquired from the FAT information that the specified file index indicates.
(Conforms to NitroROM format.)
prop.file.bottom The area bottom position that is acquired from the FAT information that the specified file index indicates.
(Conforms to NitroROM format.)
prop.file.pos Sets the same value as prop.file.top
prop.file.own_id Sets the argument id as-is.
As long as the archive's FAT conforms to the NitroROM format (determined by using the archive read callback function), this information is acquired from the FAT index that is indicated by id.file_id. The FS_COMMAND_OPENFILEDIRECT command is used to make the setting.

Command Results

Functions that use this command

See Also

FSArchive, FS_ARCHIVE_PROC_FUNC, FS_COMMAND_*, FS_SetArchiveProc

Revision History

07/12/2004 Initial Version