Scanlab RTC6 PCIe Board - Get_List_Pointer

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
413
innovators for industry
Ctrl Command get_list_pointer
Function Returns the current relative position of the input pointer as well as 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 absolute RTC6 List Memory address (offset relative to the start of “List 1”) of the
input pointer can be queried by get_input_pointer (see also comments there).
• The number of list positions until the end of the respective list (from the input pointer)
can be queried by get_list_space.
• The board-specific error variables LastError and AccError , see Chapter 6.8 ”Error
Handling”, page 130, are neither generated nor altered by get_list_pointer.
• If the input pointer is invalid when get_list_pointer is called (for example, after a
list_return), the return values are ListNo = 0 and Pos = 0xFFFFFF.
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References get_input_pointer, get_list_space