Installation guide

PicoScope 4000 Series (A API) Programmer's Guide 39
Copyright © 2008-2014 Pico Technology Ltd. All rights reserved. ps4000apg.en r1
4.20
ps4000aGetValues
PICO_STATUS ps4000aGetValues
(
int16_t handle,
uint32_t startIndex,
uint32_t * noOfSamples,
uint32_t downSampleRatio,
PS4000A_RATIO_MODE downSampleRatioMode,
uint32_t segmentIndex,
int16_t * overflow
)
This function returns block-mode data, either with or without downsampling, 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 downsampling factor that will be applied to
the raw data. Multiple downsampling modes can be bitwise-ORed
together, but the downSampleRatio must be the same for all
modes.
downSampleRatioMode, whether to use downsampling to reduce
the amount of data. See Downsampling.
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 pattern
with bit 0 corresponding to Channel A.
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