Pico Communications PicoScope 2104 Network Card User Manual


 
PicoScope 2104 & 2105 PC Oscilloscope User Guide
10
Copyright 2006 Pico Technology Limited. All rights reserved.PS2100044-1.0
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
for
time_units
is 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
.