RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
331
innovators for industry
Ctrl Command load_disk
Function
loads into the protected memory area (“List 3”) the indexed characters, text strings and
subroutines previously stored in a binary file via
and returns the number of
actually loaded list commands.
Call
NoOfLoadedCommands = load_disk( Name, Mode )
Parameter
Name
File name as a pointer to a null-terminated ANSI string
Mode
This parameter (unsigned 32-bit value) specifies how the loading procedure
will be executed:
=0: The internal management tables for indexed characters, text strings and
subroutines will be initialized (all old references are thereby lost) and the
input pointer will be set to the beginning of “List 3“ (the resulting loading
process overwrites list commands stored there).
>0: Internal management tables will not be initialized (all old references are
initially retained, but then replaced or supplemented by other references
during the loading process, depending on the file’s content) and the input
pointer will be set to the position after the last stored (via
) indexed character, text string or subroutine
(the resulting loading process will
not
overwrite the list commands of old
indexed characters, text strings and subroutines).
Result
The number of commands loaded via
load_disk
, as an unsigned 32-bit value
