Installation guide

PicoScope 4000 Series (A API) Programmer's Guide 43
Copyright © 2008-2014 Pico Technology Ltd. All rights reserved. ps4000apg.en r1
4.24
ps4000aGetValuesOverlappedBulk
PICO_STATUS ps4000aGetValuesOverlappedBulk
(
int16_t handle,
uint32_t startIndex,
uint32_t * noOfSamples,
uint32_t downSampleRatio,
PS4000A_RATIO_MODE downSampleRatioMode,
uint32_t fromSegmentIndex,
uint32_t toSegmentIndex,
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 rapid
block mode. The advantage of this method 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,
ps4000aGetValuesBulk calling sequence. This slightly reduces the dead time
between successive captures in rapid 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
Rapid block mode
Arguments
handle, the handle of the device
startIndex: see ps4000aGetValues
* noOfSamples: see ps4000aGetValues
downSampleRatio: see ps4000aGetValues
downSampleRatioMode: see ps4000aGetValues
fromSegmentIndex: see ps4000aGetValuesBulk
toSegmentIndex: see ps4000aGetValuesBulk
* overflow, see ps4000aGetValuesBulk
Returns
PICO_OK
PICO_POWER_SUPPLY_CONNECTED
PICO_POWER_SUPPLY_NOT_CONNECTED
PICO_INVALID_HANDLE
PICO_INVALID_PARAMETER
PICO_DRIVER_FUNCTION