Scanlab RTC6 PCIe Board - Get_Sub_Pointer

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
431
innovators for industry
Ctrl Command get_sub_pointer
Function Returns the absolute start address of an indexed subroutine.
Call SubPointer = get_sub_pointer( Index )
Parameters Index Index of the indexed subroutine. As an unsigned 32-bit value.
Allowed value 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 RTC6 List Memory area “List 3” depends on
whether the subroutine has been loaded into the protected RTC6 List Memory area
“List 3” or an unprotected subroutine has been only subsequently referenced.
• If Index > 1023 or if no subroutine has been referenced with the specified index, then
get_sub_pointer returns the value “–1” (for example, 2
32
–1).
• This command is useful for checking if a subroutine has already been defined or for
calling an indexed subroutine by 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.
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References get_char_pointer, get_text_table_pointer