Set_Char_Pointer - Scanlab RTC6 PCIe Board Installation And Operation Manual

Ctrl Command set_char_pointer
Function Stores the absolute start address of a command list in the internal management table for
indexed characters.
set_char_pointer( Char, Pos )
Call
Char
Parameters
Pos
• If Char > 1023 and/or Pos > (2
Comments
(get_last_error
• The set_char_pointer command can be used for referencing an indexed character. It
thereby becomes an indexed character that is protectable by
and/or callable by the index.
• set_char_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
• The start addresses of command lists that are to be referenced with set_char_pointer
can be queried by
• set_char_pointer only stores starting addresses in the internal management table. An
indexed character only gains protection by a subsequent
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
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_char
RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
Index of the indexed character whose starting address Pos should be entered
in the management table. As an unsigned 32-bit value.
Allowed value range: [0...1023].
The same applies as for load_char:
Char = character set number × 256 + ASCII number of the character
(character sets are numbered 0 to 3).
Absolute start address. As an unsigned 32-bit value.
Allowed value range: [0...(2
return code RTC6_PARAM_ERROR).
copy_dst_src command for index management.
get_input_pointer
23
–1)].
23
–1), then set_char_pointer is not executed
before saving the command lists.
save_disk/load_disk
save_disk/load_disk
list_return and
618