User manual

Programming with the PicoScope 6000 Series42

3.9.19

ps6000GetValuesOverlapped

PICO_STATUS ps6000GetValuesOverlapped

(

short handle,

unsigned long startIndex,

unsigned long * noOfSamples,

unsigned long downSampleRatio,

PS6000_RATIO_MODE downSampleRatioMode,

unsigned long segmentIndex,

short * overflow

)

This function allows you to make a deferred data-collection request, which will later be

executed, and the arguments validated, when you call ps6000RunBlock in block mode.

The advantage of this function is that the driver makes contact with the scope only

once, when you call ps6000RunBlock, compared with the two contacts that occur

when you use the conventional ps6000RunBlock, ps6000GetValues calling sequence.

This slightly reduces the dead time between successive captures in block mode.

After calling ps6000RunBlock, you can optionally use ps6000GetValues to request

further copies of the data. This might be required if you wish to display the data with

different data reduction settings.

Applicability

Block mode

Arguments

handle, the handle of the device

startIndex: see ps6000GetValues

* noOfSamples: see ps6000GetValues

downSampleRatio: see ps6000GetValues

downSampleRatioMode: see ps6000GetValues

segmentIndex: see ps6000GetValues

* overflow: see ps6000GetValuesBulk

Returns

PICO_OK

PICO_INVALID_HANDLE

PICO_INVALID_PARAMETER

PICO_DRIVER_FUNCTION