8. Function specifications-6

8.6 Other

List

Title Function specifications

Function Moving the CD pickup

Function Name GFS_CdMovePickup

No 6.1

Form

Sint32 GFS_CdMovePickup (GfsHn gfs)

input

gfs: file handle

output

none

Function value

Error code.

function

Move the CD pickup to the position of the access pointer.
Used to reduce the pickup seek time when reading from a CD with the GFS_Fread, GFS_NwFread, or GFS_NwCdRead functions.

List

Title Function specifications

Function Error handling Function settings

Function Name GFS_SetErrFunc

No 6.2.

Form

void GFS_SetErrFunc (void (* func) (GfsErrFunc func), void * obj)

input

func	: Function called when an error occurs
obj	: First argument of func function

output

none

Function value

none

function

Register the function to be called when an error occurs.
Setting func to NULL leaves the error-handling function unregistered.

List

Title Function specifications

Function Getting error status

Function Name GFS_GetErrStat

No 6.3

Form

void GFS_GetErrStat (GfsErrStat * stat)

input

none

output

stat: Error status

Function value

none

function

Gets the error status of the last executed library function.

List

Title Function specifications

Function Track number conversion

Function Name GFS_ConvTno

No 6.4

Form

Sint32 GFS_ConvTno (Sint32 logtno)

input

logtno: Logical track number (track number handled by game disc)

output

none

Function value

Physical track number (track number on DDS disc)

function

Converts logical track numbers to physical track numbers. When DDS (Direct Dispatch System) is not being executed, the logical track number = physical track number.