User Manual

PicoScope 4000 Series Programmer's Guide 37

4.10.18

ps4000GetValuesBulk

PICO_STATUS ps4000GetValuesBulk

(

short handle,

unsigned long * noOfSamples,

unsigned short fromSegmentIndex,

unsigned short toSegmentIndex,

short * 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 aggregation.

Applicability

Rapid block mode

Arguments

handle, the handle of the device

* noOfSamples, On entering the API, the number of samples

required. On exiting the API, 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

* overflow, equal to or larger than 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