Scanlab RTC6 PCIe Board - Set_Sub_Pointer

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
748
innovators for industry
Ctrl Command set_sub_pointer
Function Stores the absolute start address of a command list in the internal management table for
indexed subroutines.
Call set_sub_pointer( Index, Pos )
Parameters Index Index of the indexed subroutine whose starting address Pos should be entered
in the management table.
As an unsigned 32-bit value.
Allowed value range: [0…1023]).
Pos Absolute start address.
As an unsigned 32-bit value.
Allowed value range: [0…(2
23
–1)].
Comments • If Index > 1023 and/or Pos > (2
23
–1), then set_sub_pointer is not executed
(get_last_error return code RTC6_PARAM_ERROR ).
• The set_sub_pointer command can be used for referencing a nonindexed subroutine,
which thereby becomes an indexed subroutine that is protectable by
save_disk/load_disk and/or callable by the index.
• set_sub_pointer can also be used to reference anew an indexed subroutine, character
or text string so that it can also be called by a second index. Here, it is preferable to use
the copy_dst_src command for index management.
• The start addresses of command lists that are to be referenced with set_sub_pointer
can be queried by get_input_pointer before loading the command lists.
• set_sub_pointer only stores starting addresses in the internal management table. An
indexed subroutine only gains protection by a subsequent save_disk/load_disk
command.
• Pos should not be an arbitrary address within a list. Instead, it should be the starting
address of an actually existing subroutine that has been finalized by list_return and
does not contain set_end_of_list.
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References load_sub