PROGRAMMER'S GUIDEFile system library
BackForward
File system library

2. Basic matters


2.1 Definition of terms

Table 2.1 defines the terms used in the file system library description.

Table 2.1 Definition of terms
 the term
 meaning
 CD buffer
 A buffer that stores data read from a CD on a sector-by-sector basis. It has a capacity of 200 sectors.
 DOS file
 Files on IBM-PC accessible via SCSI interface. Can be used in the debug library.
 Memory file
 Files placed on SIMM. It is available in the debug library.
 Access pointer
 Location to access the file (unit: sector).
 Current directory
 The directory referenced when opening a file.
 Debug file
 A generic term for DOS files and memory files.
 Buffer partition
 A CD buffer divided into multiple logical partitions.
One buffer partition is dedicated to each opened file.
 File identifier
 A sequence number in the directory to identify the file.
It takes a value from 0 to (number of directory records-1). However, 0 indicates your directory and 1 indicates the parent directory.
 Frame address
(FAD)
 A numbered frame by frame, with the absolute time 00:00:00 on the CD as 0. It corresponds to absolute time and one-to-one. Access the CD using the frame address as the key, not the absolute time.
 Main processing
 A series of processes starting from CPU reset. A term for interrupt handling.
 Interrupt processing
 A process that is triggered by an interrupt. A term for the main process.

2.2 Notation

Describes the notation used in the file system description.

(1) Name grouping
ABC_ ~ means that there are several names that start with ABC_. For example, ABC_X, ABC_Y, ABC_Z.

(2) Symbol designation
! MMM / SSS, represents the symbol SSS defined in the module MMM. It is also the notation used in the E7000 command.

(3) Hexadecimal notation
A number with an "H" at the end indicates that it is a hexadecimal number.

2.3 Name restrictions
The file system library uses the following names as function names, variable names, type names, and macro names.

 Function name, variable name
 GF ~ and gf ~
 Model name
 Gf ~
 Macro name
 GF ~

Applications that use this library should be careful not to run into these names.

2.4 Access macro
In the CD library, which includes the file system library, the members of the structure are referenced using macros called "access macros". With the access macro, you can also get / set the member value.
The following advantages can be obtained by using the access macro.


BackForward
PROGRAMMER'S GUIDEFile system library
Copyright SEGA ENTERPRISES, LTD., 1997