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

Ctrl Command get_waveform
Function transfers to the PC the data that was measured and stored onto the RTC
or set_trigger4
Call
get_waveform( Channel, Number, Ptr )
Parameters
Channel
Number
Ptr
Comments • In the following cases, no data is transferred
RTC5_PARAM_ERROR):
– if Number = 0
– if Number > 2
– if Number > 2
rection table No=3 or No=4 with
– if Ptr = NULL
• PCI transmission errors will generate the
• Before calling get_waveform, you can check via
measurement session is currently running that was started with
set_trigger4. We recommend not reading any data when data recording is currently
active. The number Pos for the last (or current) data pair of the measurement session
can be queried via measurement_status. No more than Pos+1 data elements should
be read. Any further elements are from earlier recordings or the initialization.
® ®
RTC 4 RTC 5 Essentially unchanged functionality, however:
Even in RTC
transferred to the PC as 32-bit data. Therefore, you must evaluate the values accordingly
(see comments for get_value).
Version info Last change with version DLL 536, OUT 536: Channel = 3 and 4
References set_trigger, set_trigger4, get_value,
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
measurement channel [1 or 2; if recordings started via set_trigger4, then also
3 or 4]; specified as an unsigned 32-bit value
20
number [1...2 for set_trigger, 1...2
to transfer; specified as an unsigned 32-bit value. Values of measurement
positions 0 to (Number–1) will be transferred.
pointer (in C and C++ data type ULONG_PTR, i.e. an unsigned 32-bit or 64-bit
value) to a location in the PC's memory to where the measured values should
be transferred
20
19
when Channel = 3 or 4 was selected or if a file was loaded as cor-
®
4 compatibility mode, all values are in the RTC
19
for set_trigger4] of measured values
(get_last_error return code
load_correction_file
get_last_error return code RTC5_SEND_ERROR.
measurement_status
®
5's 20-bit range, but get
get_values
®
5 via set_trigger
whether a
set_trigger or
294