Load_Disk - Scanlab RTC6 PCIe Board Installation And Operation Manual

Ctrl Command load_disk
Function Loads into the protected
strings and subroutines previously stored in a binary file by
number of actually loaded list commands.
NoOfLoadedCommands = load_disk( Name, Mode )
Call
Name
Parameters
Mode
Result The number of commands loaded by load_disk.
As an unsigned 32-bit value.
• For Name = NULL, only the internal management tables are initialized as with Mode = 0
Comments
(no loading occurs, no "empty" binary file must be provided). Otherwise, load_disk
can only be used for reading files that were stored with save_disk.
• For all indexed characters, text strings and subroutines in the specified file, load_disk
executes a corresponding load_char,
pertaining list commands are thereby written to the protected
"List 3" and the entries are made in the internal management tables in accordance with
the index assignment stored in the file. If there is no character, text string or subroutine
for a particular index in the specified file, then no list commands are loaded for this
index, and if Mode > 0 then any already existing entries in the internal management
table remains unaltered. Thus, supplementary loading of indexed characters, text
strings and subroutines from various files is possible.
RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
RTC6 List Memory
File name or NULL.
As a pointer to a \0-terminated ANSI string.
Determines how the loading procedure is executed.
As an unsigned 32-bit value.
= 0: The internal management tables for indexed characters, text strings
and subroutines are initialized (all old references are thereby lost) and
the input pointer is set to the beginning of "List 3" (the resulting
loading process overwrites list commands stored there).
> 0: Internal management tables are not 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 is set to the position after the last
stored (by load_char,
character, text string or subroutine (the resulting loading process
does not overwrite the list commands of old indexed characters, text
strings and subroutines).
area "List 3" the indexed characters, text
save_disk
load_text_table or load_sub) indexed
load_text_table or load_sub
RTC6 List Memory
and returns the
command. The
area
498