User Manual

PicoScope 4000 Series Programmer's Guide 35
Copyright © 2008-2011 Pico Technology Ltd. All rights reserved. ps4000pg.en
4.10.16
ps4000GetValues
PICO_STATUS ps4000GetValues
(
short handle,
unsigned long startIndex,
unsigned long * noOfSamples,
unsigned long downSampleRatio,
short downSampleRatioMode,
unsigned short segmentIndex,
short * overflow
)
This function returns block-mode data, either with or without aggregation, starting at
the specified sample number. It is used to get the stored data from the scope after
data collection has stopped.
Applicability
Block mode, rapid block mode
Arguments
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 requested; on
exit, the number of samples actually returned.
downSampleRatio, the aggregation factor that will be applied to
the raw data.
downSampleRatioMode, whether to use aggregation to reduce the
amount of data. The available values are: -
RATIO_MODE_NONE (downSampleRatio is ignored)
RATIO_MODE_AGGREGATE (uses aggregation)
segmentIndex, the zero-based number of the memory segment
where the data is stored.
overflow, returns a set of flags that indicate whether an
overvoltage has occurred on any of the channels. It is a bit pattern
with bit 0 denoting Channel A and bit 1 Channel B.
Returns
PICO_OK
PICO_INVALID_HANDLE
PICO_NO_SAMPLES_AVAILABLE
PICO_DEVICE_SAMPLING
PICO_NULL_PARAMETER
PICO_SEGMENT_OUT_OF_RANGE
PICO_INVALID_PARAMETER
PICO_TOO_MANY_SAMPLES
PICO_DATA_NOT_AVAILABLE
PICO_STARTINDEX_INVALID
PICO_INVALID_SAMPLERATIO
PICO_INVALID_CALL
PICO_NOT_RESPONDING
PICO_MEMORY