-- Attached file included as plaintext by Listar --
-- File: deviceinfo.txt
--------------------------------
DeviceInfo kernel function
Description:
Implements various file system related functions:
* GET_DEVICE returns the drive/device on which "input" resides in output
(and a pointer to the terminating NULL in the accumulator)
* GET_CURRENT_DEVICE returns the drive/device that contains the CWD
(and a pointer to the terminating NULL in the accumulator)
* PATHS_EQUAL returns TRUE if the two supplied paths point to the same place.
* IS_FLOPPY returns TRUE if the supplied path resides on a floppy disk.
Syntax:
#define GET_DEVICE 0
#define GET_CURRENT_DEVICE 1
#define PATHS_EQUAL 2
#define IS_FLOPPY 3
heap_string *DeviceInfo(GET_DEVICE, heap_string *input, heap_string *output)
heap_string *DeviceInfo(GET_CURRENT_DEVICE, heap_string *output)
int DeviceInfo(PATHS_EQUAL, heap_string *path1, heap_string *path2)
int DeviceInfo(IS_FLOPPY, heap_string *path)
------------------------------------------
CheckSaveGame kernel function
Description:
Returns TRUE if the specified save game is valid and loadable (i.e., not for
another game/interpreter/version).
Syntax:
int CheckSaveGame(heap_string *GAME_ID, int save_nr)
------------------------------------------
GetSaveDir kernel function
Description:
Returns a pointer to the directory used for storing save games (which may be
overridden by pressing "Change Directory").
Syntax:
heap_string *GetSaveDir(void)
-------------------------------------------
CheckFreeSpace kernel function
Description:
Returns TRUE if there would be enough space left on the specified path to
save the current game (but doesn't actually save).
Syntax:
int CheckFreeSpace(heap_string *path)
--------------------------------------------
GetSaveFiles kernel function
Description:
Returns an array of strings describing the existing save games for GAME_ID.
Syntax:
int GetSaveFiles(heap_string *GAME_ID, heapptr *strspace, heapptr **ptrs)
Comments:
The strings are put into strspace one by one, and heap pointers to each of
them are put into the ptrs array.
The number is saved games is returned in the accumulator.
---------------------------------------------
