Installation guide

PicoScope 4000 Series (A API) Programmer's Guide 41

4.22

ps4000aGetValuesBulk

PICO_STATUS ps4000aGetValuesBulk

(

int16_t handle,

uint32_t * noOfSamples,

uint32_t fromSegmentIndex,

uint32_t toSegmentIndex,

unit32_t downSampleRatio,

PS4000A_RATIO_MODE downSampleRatioMode,

int16_t * overflow

)

This function allows more than one waveform to be retrieved at a time in rapid block

mode. The waveforms must have been collected sequentially and in the same run.

This method of collection does not support downsampling.

Applicability

Rapid block mode

Arguments

handle, the handle of the device

* 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. The data retrieved

always starts with the first sample captured.

fromSegmentIndex, the first segment from which the waveform

should be retrieved

toSegmentIndex, the last segment from which the waveform

should be retrieved

downSampleRatio, see Downsampling

downSampleRatioMode, see Downsampling

* overflow, an array of at least as many integers as the number

of waveforms to be retrieved. Each segment index has a separate

overflow element, with overflow[0] containing the

fromSegmentIndex and the last index the toSegmentIndex.

Returns

PICO_OK

PICO_INVALID_HANDLE

PICO_INVALID_PARAMETER

PICO_SEGMENT_OUT_OF_RANGE

PICO_NO_SAMPLES_AVAILABLE

PICO_STARTINDEX_INVALID

PICO_NOT_RESPONDING