PICO PicoScope 3000 A Series Programmer's Guide

PicoScope 3000A Series Prog rammer's Guide 49
Copyright © 2011-2013 Pico Technology Limited. All rights reserved. ps3000abpg.en r9
2.12.24
ps3000aGetValuesOverlappedBulk
PICO_STATUS ps3000aGetValuesOverlappedBulk
(
short handle,
unsigned long startIndex,
unsigned long * noOfSamples,
unsigned long downSampleRatio,
PS3000A_RATIO_MODE downSampleRatioMode,
unsigned short fromSegmentIndex,
unsigned short 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 ps3000aRunBlock in rapid block
mode. The advantage of this method is that the driver makes contact with the scope
only once, when you call ps3000aRunBlock, compared with the two contacts that
occur when you use the conventional ps3000aRunBlock, ps3000aGetValuesBulk calling
sequence. This slightly reduces the dead time between successive captures in rapid
block mode.
After calling ps3000aRunBlock, you can optionally use ps3000aGetValues 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 ps3000aGetValues
* noOfSamples, see ps3000aGetValues
downSampleRatio, see ps3000aGetValues
downSampleRatioMode, see ps3000aGetValues
fromSegmentIndex, see ps3000aGetValuesBulk
toSegmentIndex, see ps3000aGetValuesBulk
* overflow, see ps3000aGetValuesBulk
Returns
PICO_OK
PICO_POWER_SUPPLY_CONNECTED
PICO_POWER_SUPPLY_NOT_CONNECTED
PICO_INVALID_HANDLE
PICO_INVALID_PARAMETER
PICO_DRIVER_FUNCTION

PICO PicoScope 3000 A Series Specifications

General

Brand	PICO
Model	PicoScope 3000 A Series
Category	Test Equipment
Language	English