PICO picoscope 3204, User Manual

Page: 26 / 40

PicoScope 3000 Series User Guide
25
Copyright 2005 Pico Technology Limited. All rights reserved.
PS3000044 1.4
3.3.15
ps3000_get_times_and_values
long ps3000_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
oscilloscope 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,
buffer_b,
buffer_c,
buffer_d,
pointers to the buffers that receive data from the specified
channels (A, B, C or D). A pointer is unused if the oscilloscope is not
collecting data from that channel. If a pointer is
NULL
, nothing will be
written to it.
overflow
, a bit pattern indicating whether an overflow has occurred on
a channel. Bit 0 is the LSB.
Bit 0 --> channel A
Bit 1 --> channel B
Bit 2 --> channel C
Bit 3 --> channel D
time_units
, which can be one of:
PS3000_FS
(
0
),
PS3000_PS
(
1
),
PS3000_NS
(
2
),
PS3000_US
(
3
),
PS3000_MS
(
4
) or
PS3000_S
(
5
)
which are femtoseconds, picoseconds, nanoseconds (default),
microseconds, milliseconds and seconds respectively.
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 per channel 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
ps3000_get_timebase in order to acquire the most suitable
time_units
.