RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
271
Ctrl Command get_list_pointer
Function provides the input pointer’s current (relative) position and the list number.
Call
get_list_pointer( &ListNo, &Pos )
Returned
parameter
values
ListNo
Number of the list in which the input pointer is currently located; as a pointer
to an unsigned 32-bit value [1…3]
Pos
Current position of the input pointer (offset relative to the start of the
respective list) as a pointer to an unsigned 32-bit value
Comments • The input pointer’s absolute list buffer address (offset relative to the start of “List 1”)
can be queried via get_input_pointer (page 269) (also see comments there).
• The number of list positions until the end of the respective list (from the input pointer)
can be queried via get_list_space (page 272).
• The board-specific error variables
LastError
and
AccError
(see "Error Handling", page
87) are neither generated nor altered by get_list_pointer.
RTC
®
4
RTC
®
5 new command
References get_input_pointer, get_list_space
Ctrl Command get_list_serial
Function returns the number of the serial-number-set most recently selected via
select_serial_set_list (or of serial-number-set 0 after load_program_file) and the current
serial number of this serial-number-set.
Call
LastMarkedSerialNo = get_list_serial( &Set )
Result Serial number (as 64-bit IEEE floating point value)
Returned
parameter
value
Set
Number of the selected serial-number-set as a pointer to an unsigned 32-bit
value
Comments • The serial number queried via get_list_serial is typically the one most recently marked
via mark_serial or mark_serial_abs.
• For command usage, see chapter 7.5.2 "Marking Serial Numbers", page 150.
RTC
®
4
RTC
®
5new command
Version info Available beginning with version DLL 537, OUT 537
References select_serial_set_list, get_serial