Installation guide

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

4.30

ps4000aMemorySegments

PICO_STATUS ps4000aMemorySegments

(

int16_t handle,

uint32_t nSegments,

int32_t * nMaxSamples

)

This function sets the number of memory segments that the scope device will use.

By default, each capture fills the scope device's available memory. This function

allows you to divide the memory into a number of segments so that the scope can

store several captures sequentially. The number of segments defaults to 1 when the

scope device is opened.

Applicability

All modes

Arguments

handle, the handle of the required device

nSegments, the number of segments to be used, from 1 to the

number returned by ps4000aGetMaxSegments.

* nMaxSamples, on exit, the number of samples that are available

in each segment. This is independent of the number of channels, so if

more than one channel is in use then the number of samples

available to each channel is nMaxSamples divided by the number of

channels.

Returns

PICO_OK

PICO_USER_CALLBACK

PICO_INVALID_HANDLE

PICO_TOO_MANY_SEGMENTS

PICO_MEMORY