Scanlab RTC 5 PC Interface Board Installation And Operation Manual page 293

Ctrl Command get_values
Function returns the current values of up to four specified signals
Call
get_values( SignalPtr, ResultPtr )
Parameters SignalPtr pointer (in C and C++ data type ULONG_PTR, i.e. an unsigned 32-bit or 64-bit
ResultPtr pointer (in C and C++ data type ULONG_PTR, i.e. an unsigned 32-bit or 64-bit
Comments • Up to four desired signals can be simultaneously queried. The selectable signal types are
identical to those of the
allowable value range, signal types and other information). The desired signal types
must be specified via SignalPtr. The corresponding signal values will then be stored via
ResultPtr. For storage of each queried data set, the application must make available
(at the address specified via ResultPtr) 4 · 4 bytes of PC memory.
• get_values functions similarly to the
get_values will return 0 and perform no query on channels for which an invalid signal
type was specified via SignalPtr. Nevertheless, the
RTC5_PARAM_ERROR will only be generated if all four specified signal types are invalid.
• If any of the pointer parameters are NULL, then the command will not be executed (all
return values are 0) and a
generated.
® ®
RTC 4 RTC 5 new command
Even in RTC
range, but get transferred to the PC as 32-bit data. Therefore, you must evaluate the values
accordingly (see comments for get_value).
Version info • Available beginning with version DLL 516, OUT 515, RBF 512
• Last change (with version DLL 536, OUT 536): Additional selectable data signals (see
set_trigger).
References get_value, set_trigger,
Ctrl Command get_wait_status
Function returns the wait state of the RTC
Call
WaitStatus = get_wait_status()
Result wait state as an unsigned 32-bit value
Comments • If processing has stopped at a wait marker, the command get_wait_status returns the
number of this marker. See
• If no wait marker was reached, the command get_wait_status returns zero.
• Processing of the list can be resumed by calling the command release_wait.
® ®
RTC 4 RTC 5 unchanged functionality
References set_wait,
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
value) to an array of four unsigned 32-bit values, where the desired signal
types are specified
value) to an array of four signed 32-bit values, where the current values of the
up to four specified signals should be stored
set_trigger
get_last_error
®
4 compatibility mode, the four returned values are in the RTC
transform
®
5
set_wait (page
release_wait
command (refer to the comments there for the
get_value command (see comments there).
get_last_error
return code of RTC5_PARAM_ERROR will be
500).
return code
®
5's 20-bit
293