Scanlab RTC6 PCIe Board - Get_Value; Get_Values

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
445
innovators for industry
Ctrl Command get_values
Function Returns the current values of up to 4 specified signals.
Call get_values( SignalPtr, ResultPtr )
Parameters SignalPtr Pointer (in C and C++ data type ULONG_PTR, an unsigned 32-bit value or
unsigned 64-bit value) to an array of 4 unsigned 32-bit values, where the to-
be-outputted signal types are specified.
ResultPtr Pointer (in C and C++ data type ULONG_PTR, an unsigned 32-bit value or
unsigned 64-bit value) to an array of 4 signed 32-bit values, where the current
values of the up to 4 specified signals are to be stored.
Comments • Up to 4 desired signals can be simultaneously queried. The selectable signal types are
identical to those of set_trigger (refer to the comments there for the allowed value
range, signal types and other information). The to-be-outputted signal types must be
specified by SignalPtr . The corresponding signal values are then stored by ResultPtr .
For storage of each queried data set, the user program must make available (at the
address specified by ResultPtr ) 4 × 4 bytes of PC memory.
• get_values functions similarly to get_value (see comments there). get_values returns
0 and performs no query on channels for which an invalid signal type has been
specified by SignalPtr . A get_last_error return code RTC6_PARAM_ERROR is only
generated if all 4 specified signal types are invalid.
• If any of the pointer parameters are NULL, then get_values is not executed and a
get_last_error return code of RTC6_PARAM_ERROR is generated.
RTC4RTC6 New command.
Even in RTC4 Compatibility Mode, the 4 returned values are in the RTC6 20-bit range, but
are transferred to the PC as 32-bit values (see comments for get_value).
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References get_value, set_trigger, transform