Installation guide

API functions42

4.23

ps4000aGetValuesOverlapped

PICO_STATUS ps4000aGetValuesOverlapped

(

int16_t handle,

uint32_t startIndex,

uint32_t * noOfSamples,

uint32_t downSampleRatio,

PS4000A_RATIO_MODE downSampleRatioMode,

uint32_t segmentIndex,

int16_t * overflow

)

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

executed, and the arguments validated, when you call ps4000aRunBlock in block

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

only once, when you call ps4000aRunBlock, compared with the two contacts that

occur when you use the conventional ps4000aRunBlock, ps4000aGetValues calling

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

mode.

After calling ps4000aRunBlock, you can optionally use ps4000aGetValues 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 ps4000aGetValues

* noOfSamples: see ps4000aGetValues

downSampleRatio: see ps4000aGetValues

downSampleRatioMode: see ps4000aGetValues

segmentIndex: see ps4000aGetValues

* overflow: see ps4000aGetValuesBulk

Returns

PICO_OK

PICO_POWER_SUPPLY_CONNECTED

PICO_POWER_SUPPLY_NOT_CONNECTED

PICO_INVALID_HANDLE

PICO_INVALID_PARAMETER

PICO_DRIVER_FUNCTION