User manual

PicoScope 6000 Series Programmer's Guide 37

3.9.15

ps6000GetValues

PICO_STATUS ps6000GetValues

(

short handle,

unsigned long startIndex,

unsigned long * noOfSamples,

unsigned long downSampleRatio,

PS6000_RATIO_MODE downSampleRatioMode,

unsigned long 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.

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 required. On exit,

the actual number retrieved. The number of samples retrieved will

not be more than the number requested, and the data retrieved

always starts with the first sample captured.

downSampleRatio, the downsampling factor that will be applied to

the raw data.

downSampleRatioMode, which downsampling mode to use. The

available values are: -

PS6000_RATIO_MODE_NONE (downSampleRatio is ignored)

PS6000_RATIO_MODE_AGGREGATE

PS6000_RATIO_MODE_AVERAGE

PS6000_RATIO_MODE_DECIMATE

AGGREGATE, AVERAGE, and DECIMATE are single-bit constants that

can be ORed to apply multiple downsampling modes to the same

data. DISTRIBUTION mode is not implemented.

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.