pico Technology PicoScope 3425, User Manual

Page: 49 / 68

Programmer's reference
45
Copyright © 2007 Pico Technology Limited. All rights reserved. ps3425.en
Applicability Fast streaming mode only
Arguments
handle,
the handle of the required device.
start_time,
the time in nanoseconds, relative to the trigger
point, of the first data sample required.
pbuffer_a_max, pbuffer_a_min,
pointers to two buffers into
which the function will write the maximum and minimum
aggregated sample values from channel A.
pbuffer_b_max, pbuffer_b_min, pbuffer_c_max,
pbuffer_c_min, pbuffer_d_max, pbuffer_d_min,
as the
two parameters above but for channels B, C and D
overflow,
a pointer to where the function will write a bit field
indicating whether the voltage on each of the input channels has
overflowed.
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0
D C B A D C B A
common-mode
overflow
differential
overflow
triggerAt,
a pointer to where the function will write an index
into the buffers. The index is the number of the sample at the
trigger reference point. Valid only when triggered is TRUE.
triggered,
a pointer to a Boolean indicating that a trigger has
occurred and
triggerAt
is valid.
no_of_values,
the number of values required.
noOfSamplesPerAggregate,
the number of samples that the
driver should combine to form each aggregated value pair. The
pair consists of the maximum and minimum values of all the
samples that were aggregated. For channel A, the minimum value
is stored in the buffer pointed to by
pbuffer_a_min
and the
maximum value in the buffer pointed to by
pbuffer_a_max
.
Returns the number of values written to each buffer, or
0
if a parameter was out of range
15
56