Scanlab RTC 5 PC Interface Board - get_sub_pointer

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
283
innovators for industry
Ctrl Command get_sub_pointer
Function returns the absolute start address of an indexed subroutine.
Call
SubPointer = get_sub_pointer( Index )
Parameter Index Index of the indexed subroutine as an unsigned 32-bit value;
allowed range: [0 … 1023]
Result Absolute start address as an unsigned 32-bit value
Comments • The get_sub_pointer command reads from the internal management table the start
address of the indexed subroutine with the specified index. Whether the read address
resides in a protected or the unprotected memory area depends on whether the
subroutine was loaded into the protected memory area or an unprotected subroutine
was only subsequently referenced.
•If
Index > 1023 or if no subroutine was referenced with the specified index, then the
command will return the value “–1” (e.g. 2
32
–1).
• This command is useful for checking if a subroutine has already been defined or for
calling an indexed subroutine via an absolute memory address as if it were a non-
indexed subroutine. Be aware, though, that a subsequent save_disk/load_disk might
alter the absolute memory address.
RTC
®
4  RTC
®
5 new command
References get_char_pointer, get_text_table_pointer