Filter
Top Products
Technical reference
11
Copyright 2006 Pico Technology Limited. All rights reserved. PS2100044-1.0
3.3.4
ps2000_get_times_and_values
long ps2000_get_times_and_values( short handle,
long * times,
short * buffer_a,
short * buffer_b,
short * buffer_c,
short * buffer_d,
short * overflow,
short time_units,
long no_of_values )
This function is used to get values and times. It will not return any valid times if the
unit is in streaming mode. It is essential for ETS operation.
Arguments
handle
, the handle to the required device.
times
, a pointer to the buffer for the times. Each time is the interval
between the trigger event and the corresponding sample. Times
before the trigger event are negative, and times after the trigger
event are positive.
buffer_a,
pointer to the buffer that receives data from the
oscilloscope. If the pointer is
NULL
, nothing will be written to it. See
Scaling for details of data format.
buffer_b,
buffer_c,
buffer_d,
not used
overflow.
Bit 0 indicates whether an overflow has occurred.
time_units
, which can be one of the following:
PS2000_FS
(
0
) = femtoseconds,
PS2000_PS
(
1
) = picoseconds,
PS2000_NS
(
2
) = nanoseconds (default),
PS2000_US
(
3
) = microseconds,
PS2000_MS
(
4
) = milliseconds, or
PS3000_S
(
5
) = seconds.
no_of_values,
the number of data points to return. In streaming
mode, this is the maximum number of values to return.
Returns The actual number of data values returned, which may be less than
the
no_of_values
if streaming.
0
is returned if one or more of the parameters are out of range or if
the times will overflow with the
time_units
requested. Use
ps2000_get_timebase() in order to acquire the most suitable
time_units
.