Scanlab RTC6 PCIe Board - Get_Waveform_Offset

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
448
innovators for industry
Ctrl Command get_waveform_offset
Function Transfers to the PC the data that has been measured and stored onto the RTC6 by
set_trigger/set_trigger4/set_trigger8.
Call get_waveform_offset( Channel, Offset, Number, Ptr )
Parameters Channel Measurement channel.
Allowed values:
1…2 with recordings started by set_trigger.
1…4 with recordings started by set_trigger4.
1…8 with recordings started by set_trigger8.
As an unsigned 32-bit value.
Offset Start position.
As an unsigned 32-bit value.
Allowed value range: [0…max. channel size, see
set_trigger/set_trigger4/set_trigger8].
Number Number of measured values to be transferred.
The measured values from position Offset to ( Offset + ( Number –1)) are
transferred.
As an unsigned 32-bit value.
Ptr Pointer (data type ULONG_PTR in C and C++, an unsigned 32-bit or
unsigned 64-bit value) to a location in the PC memory to where the measured
values are to be transferred.
Comments • No data are transferred (get_last_error return code RTC6_PARAM_ERROR ):
– For Number = 0.
– For Number > 2
22
, if the recording has been started by set_trigger8
– For Offset + Number > max. channel size.
– For Ptr = NULL.
• PCI transmission errors generate the get_last_error return code RTC6_SEND_ERROR .
• See also set_trigger/set_trigger4/set_trigger8 on configuration of the channel.
• Prior to a get_transform_offset call or get_waveform_offset call, it can be checked
by measurement_status whether a recording is currently running that has been
sta
rted with set_trigger/set_trigger4/set_trigger8.
In addition, measurement_status can be used to read out the number Pos of data
pairs recorded during the last (or current) measurement. Read out at most Pos +1 data
elements. All other data elements are from previous recordings or initialization.
RTC4RTC6 New command.
RTC5RTC6 New command.
Version info Available as of DLL 610, OUT 610, RBF 614.
Last change DLL 635, OUT 636: Channel . Allowed values extended to 8 (previously: 4).
References get_waveform, set_trigger, set_trigger4, set_trigger8, get_value, get_values