User manual

PicoScope 6000 Series Programmer's Guide 43

3.9.20

ps6000GetValuesOverlappedBulk

PICO_STATUS ps6000GetValuesOverlappedBulk

(

short handle,

unsigned long startIndex,

unsigned long * noOfSamples,

unsigned long downSampleRatio,

PS6000_RATIO_MODE downSampleRatioMode,

unsigned long fromSegmentIndex,

unsigned long toSegmentIndex,

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 rapid block

mode. The advantage of this method 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 rapid 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

Rapid block mode

Arguments

handle, the handle of the device

startIndex: see ps6000GetValues

* noOfSamples: see ps6000GetValues

downSampleRatio: see ps6000GetValues

downSampleRatioMode: see ps6000GetValues

fromSegmentIndex: see ps6000GetValuesBulk

toSegmentIndex: see ps6000GetValuesBulk

* overflow, see ps6000GetValuesBulk

Returns

PICO_OK

PICO_INVALID_HANDLE

PICO_INVALID_PARAMETER

PICO_DRIVER_FUNCTION