Technical reference
15
Copyright 2006 Pico Technology Limited. All rights reserved. PS2100044-1.0
3.3.10
ps2000_run_block
short ps2000_run_block ( short handle,
long no_of_samples,
short timebase,
short oversample,
long * time_indisposed_ms )
This function tells the unit to start collecting data in block mode.
Arguments
handle
, the handle to the required device.
no_of_samples
, the number of samples to return.
timebase
, a code between 0 and the maximum timebase (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:
oversample
, the oversample factor, a number between 1 and 256.
See oversampling for more information.
time_indisposed_ms
, a pointer to the
time_indisposed_ms
. This is
the approximate time, in milliseconds, that the ADC will take to collect
data. If a trigger is set, it is measured from the trigger event. It is
calculated as:
(sample interval) x (number of samples required)
Note: The actual time may differ from computer to computer,
depending on how fast the computer can respond to I/O requests.
Returns
0
if one of the parameters is out of range, otherwise
1
.
