10
PicoScope 2104 & 2105 PC Oscilloscope User Guide
3.3.3 ps2000_get_timebase
short ps2000_get_timebase ( | short | handle, |
| short | timebase, |
| long | no_of_samples, |
| long | * time_interval_ns, |
| short | * time_units, |
| short | oversample, |
| long | * max_samples) |
This function discovers which timebases are available on the oscilloscope. This function should be called after channel and ETS options have been set.
Arguments
handle, the handle to the required device.
timebase, a code between 0 and the maximum timebase number (depending on variant). Timebase 0 is the fastest timebase, equal to the maximum sampling frequency (
) given in the Specifications. Each successive timebase is half the frequency of the previous one. 
, the sampling frequency, is given by:
no_of_samples, the number of samples required. This value is used to calculate the most suitable time unit to use.
time_interval_ns, a pointer to the time interval, in nanoseconds, between readings at the selected timebase. If a null pointer is passed, nothing will be written here.
time_units, a pointer to the most suitable time units to return data in, when calling ps2000_get_times_and_values(). A list of values
foris given under ps2000_get_times_and_values(). If a null pointer is passed, nothing will be written here.
oversample, the oversampling factor required, between 1 and 256. See oversampling for an explanation.
max_samples, a pointer to the maximum number of samples available. The number 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.
Returns
1 if all parameters are in range, otherwise 0.
Copyright 2006 Pico Technology Limited. All rights reserved. |