Entry
R0 = 0 : Load into heap block
R1 -> DataSave or DataLoad message block
R2 = block pointer of block to receive file, or 0 to create new block
R3 = offset in block to place file
R0 = 1 : Load into fixed block
R1 -> DataSave or DataLoad message block
R2 -> block to receive file
R3 = length of block
Use this SWI to load files from the filer or other applications. If R0=0 then the file is loaded into a WimpExt_Heap block, and can be any length, memory permitting. If R0=1 then the file is loaded into a fixed area of memory, and will not be loaded if it exceeds the length of the area. When you receive the DataSave or DataLoad message, pass the block onto WimpExt_DataLoad, and the transfer will be handled automatically. As long as this SWI doesn‘t return an error, when the transfer has finished, WimpExtension will send you a message, number &45784, with the word at R1+20 having the following meaning :
0 = file not loaded. Error block at R1+28
1 = file transferred successfully from another task
2 = file loaded successfully from disc
A pointer to the block‘s anchor is at R1+24, if it was loaded into a heap block. Otherwise a pointer to the area is at R1+24. If R1+20<>0 then the rest of the block contains :
R1+28 = length of file
R1+32 = load address of file
R1+36 = exec address of file
R1+40 = filename (leafname if transferred from task)
Obviously you need to have initialised a heap to use this SWI. Note that WimpExtension won‘t free the block if there‘s an error; your error handler must do this if appropriate. The load and exec addresses don‘t indicate the date if the file was transferred from another task (the relevant bits will all be zero).
Provided by DataTrans
[sh-index] Back to list of manuals
|
| |
