RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
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
value) to an array of four unsigned 32-bit values, where the desired signal
types are specified
ResultPtr
pointer (in C and C++ data type ULONG_PTR, i.e. an unsigned 32-bit or 64-bit
value) to an array of four signed 32-bit values, where the current values of the
up to four specified signals should be stored
Comments • Up to four desired signals can be simultaneously queried. The selectable signal types are
identical to those of the set_trigger command (refer to the comments there for 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_value command (see comments there).
get_values will return 0 and perform no query on channels for which an invalid signal
type was specified via
SignalPtr
. Nevertheless, the get_last_error return code
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 get_last_error return code of
RTC5_PARAM_ERROR
will be
generated.
RTC
®
4
RTC
®
5new command
Even in RTC
®
4 compatibility mode, the four returned values are in the RTC
®
5’s 20-bit
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, transform
Ctrl Command get_wait_status
Function returns the wait state of the RTC
®
5
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 set_wait (page 500).
• 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, release_wait
To Next Page
Loading...
