User Manual

Programming with the PicoScope 4000 Series28

4.10.9

ps4000GetTimebase

PICO_STATUS ps4000GetTimebase

(

short handle,

unsigned long timebase,

long noSamples,

long * timeIntervalNanoseconds,

short oversample,

long * maxSamples

unsigned short segmentIndex

)

This function discovers which timebases are available on the oscilloscope. You should

set up the channels using ps4000SetChannel first.

Applicability

All modes

Arguments

handle, the handle of the required device.

timebase, a code between 0 and 2

-1 that specifies the sampling

interval (see timebase guide).

noSamples, the number of samples required. This value is used to

calculate the most suitable time unit to use.

timeIntervalNanoseconds, a pointer to the time interval

between readings at the selected timebase. If a null pointer is

passed, nothing will be written here.

oversample, the amount of oversample required. An oversample

of 4, for example, would quadruple the time interval and quarter the

maximum samples, and at the same time would increase the

effective resolution by one bit. See the topic on oversampling.

maxSamples, a pointer to the maximum number of samples

available. The maximum samples may vary depending on the

number of channels enabled, the timebase chosen and the

oversample selected. If this pointer is null, nothing will be written

here.

segmentIndex, the number of the memory segment to use.

Returns

PICO_OK

PICO_INVALID_HANDLE

PICO_TOO_MANY_SAMPLES

PICO_INVALID_CHANNEL

PICO_INVALID_TIMEBASE

PICO_INVALID_PARAMETER