User Manual

Programming with the PicoScope 4000 Series46

4.10.27

ps4000MemorySegments

PICO_STATUS ps4000MemorySegments

(

short handle

unsigned short nSegments,

long * 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 8,192

nMaxSamples, returns 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