Installation guide

PicoScope 4000 Series (A API) Programmer's Guide 61

4.40

ps4000aSetDataBuffers

PICO_STATUS ps4000aSetDataBuffers

(

int16_t handle,

PS4000A_CHANNEL channel,

int16_t * bufferMax,

int16_t * bufferMin,

int32_t bufferLth,

uint32_t segmentIndex,

PS4000A_RATIO_MODE mode

)

This function registers your data buffers, for receiving downsampled data, with the

PicoScope 4000 driver. You need to allocate memory for the buffers before calling this

function.

Applicability

All sampling modes.

For non-downsampled data, use ps4000aSetDataBuffer instead.

Arguments

handle, the handle of the required device.

channel, the channel for which you want to set the buffers. Use

one of these constants: -

PS4000A_CHANNEL_A ... PS4000A_CHANNEL_H

* 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 when

downSampleRatio > 1 (downsampling modes other than

aggregation). Not used when downSampleRatio is 1 (aggregation

mode).

bufferLth, specifies the size of the bufferMax and bufferMin

arrays.

segmentIndex, the serial number of the segment to be retrieved.

mode, the type of downsampling to use. See Downsampling.

Returns

PICO_OK

PICO_INVALID_HANDLE

PICO_INVALID_CHANNEL