Prog ramming the 3000A Series oscilloscopes44
Copyright © 2011-2013 Pico Technology Limited. All rights reserved.ps3000abpg.en r9
2.12.20
ps3000aGetValues
PICO_STATUS ps3000aGetValues
(
short handle,
unsigned long startIndex,
unsigned long * noOfSamples,
unsigned long downSampleRatio,
PS3000A_RATIO_MODE downSampleRatioMode,
unsigned short segmentIndex,
short * overflow
)
This function returns block-mode data, with or without downsampling, starting at the
specified sample number. It is used to get the stored data from the driver after data
collection has stopped.
Block mode, rapid block mode
handle, the handle of the required device.
startIndex, a zero-based index that indicates the start point for
data collection. It is measured in sample intervals from the start of
the buffer.
* noOfSamples, on entry, the number of samples required. On
exit, the actual number retrieved. The number of samples retrieved
will not be more than the number requested, and the data retrieved
starts at startIndex.
downSampleRatio, the downsampling factor that will be applied to
the raw data.
downSampleRatioMode, which downsampling mode to use. The
available values are:-
PS3000A_RATIO_MODE_NONE (downSampleRatio is ignored)
PS3000A_RATIO_MODE_AGGREGATE
PS3000A_RATIO_MODE_AVERAGE
PS3000A_RATIO_MODE_DECIMATE
AGGREGATE, AVERAGE, DECIMATE are single-bit constants that can
be ORed to apply multiple downsampling modes to the same data.
segmentIndex, the zero-based number of the memory segment
where the data is stored.
* overflow, on exit, a set of flags that indicate whether an
overvoltage has occurred on any of the channels. It is a bit field with
bit 0 denoting Channel A.