API Functions
29Copyright © 2006–2022 Pico Technology Ltd. All rights reserved.ps2000pg.en-12
PicoScope 2000 Series Programmer's Guide
5.9 ps2000_get_values
int32_t ps2000_get_values
(
int16_t handle
int16_t *buffer_a,
int16_t *buffer_b,
int16_t *buffer_c,
int16_t *buffer_d,
int16_t *overflow,
int32_t no_of_values
)
This function is used to get values in compatible streaming mode after calling
ps2000_run_streaming, or in block mode after calling ps2000_run_block.
Note that if you are using block mode or ETS mode and call this function before the
oscilloscope is ready, no capture will be available and the driver will not return any samples.
Compatible streaming mode and block mode only
Does nothing if ETS triggering is enabled. Use
ps2000_get_times_and_values instead.
Do not use in fast streaming mode. Use
ps2000_get_streaming_last_values instead.
handle: the handle of the required oscilloscope
buffer_a, buffer_b: pointers to the buffers that receive data from the
specified channels (A and B). A pointer is not used if the oscilloscope is not
collecting data from that channel. If a pointer is NULL, nothing will be written
to it.
buffer_c, buffer_d: not used
overflow: on exit, contains a bit pattern indicating whether an overflow
has occurred and, if so, on which channel. Bit 0 is the least significant bit.
The bit assignments are as follows:
Bit 0 - Ch A overflow
Bit 1 - Ch B overflow
no_of_values: the number of data points to return. In streaming mode,
this is the maximum number of values to return.
The actual number of data values per channel returned, which may be less
than no_of_values if streaming
0: if one of the parameters is out of range or the oscilloscope is not in a
suitable mode