User manual

PicoScope 6000 Series Programmer's Guide 63
Copyright © 2009-2013 Pico Technology Ltd. All rights reserved. ps6000pg.en r9
3.9.36
ps6000SetDataBuffersBulk
PICO_STATUS ps6000SetDataBuffersBulk
(
short handle,
PS6000_CHANNEL channel,
short * bufferMax,
short * bufferMin,
unsigned long bufferLth,
unsigned long waveform,
PS6000_RATIO_MODE downSampleRatioMode
)
This function tells the driver where to find the buffers for aggregated data for each
waveform in rapid block mode. The number of waveforms captured is determined by
the nCaptures argument sent to ps6000SetNoOfCaptures. Call one of the GetValues
functions to retrieve the data after capture. If you do not need two buffers, because
you are not using aggregate mode, then you can optionally use
ps6000SetDataBufferBulk instead.
Applicability
Rapid block mode with aggregation
Arguments
handle, the handle of the device
channel, the input channel to use with the buffer
* bufferMax, a buffer to receive the maximum data values in
aggregation mode, or the non-aggregated values otherwise
* bufferMin, a buffer to receive the minimum data values in
aggregate mode. Not used in other downsampling modes.
bufferLth, the size of the buffer
waveform, an index to the waveform number between 0 and
nCaptures - 1
downSampleRatioMode: see ps6000GetValues
Returns
PICO_OK
PICO_INVALID_HANDLE
PICO_INVALID_CHANNEL
PICO_INVALID_PARAMETER
PICO_RATIO_MODE_NOT_SUPPORTED
PICO_DRIVER_FUNCTION