
PicoScope 3000A Series Prog rammer's Guide
63
Copyright © 2011-2013 Pico Technology Limited. All rights reserved.
ps3000abpg.en r9
2.12.37 ps3000aRunBlock
PICO_STATUS ps3000aRunBlock
(
short handle,
long noOfPreTriggerSamples,
long noOfPostTriggerSamples,
unsigned long timebase,
short oversample,
long * timeIndisposedMs,
unsigned short segmentIndex,
ps3000aBlockReady lpReady,
void * pParameter
)
This function starts collecting data in
. For a step-by-step guide to this
process, see
.
The number of samples is determined by
noOfPreTriggerSamples
and
noOfPostTriggerSamples
(see below for details). The total number of samples
must not be more than the size of the
referred to by
segmentIndex.
Applicability
Arguments
handle,
the handle of the required device.
noOfPreTriggerSamples,
the number of samples to return
before the trigger event. If no trigger has been set then this
argument is ignored and
noOfPostTriggerSamples
specifies the
maximum number of samples to collect.
noOfPostTriggerSamples,
the number of samples to be taken
after a trigger event. If no trigger event has been set then this
specifies the maximum number of samples to be taken. If a trigger
condition has been set, this specifies the number of samples to be
taken after a trigger has fired, and the number of samples to be
collected is then: -
noOfPreTriggerS noOfPostTriggerSamples
timebase,
a number in the range 0 to 2
32
-1. See the
oversample,
not used.
* timeIndisposedMs,
on exit, the time, in milliseconds, that the
scope will spend collecting samples. This does not include any auto
trigger timeout. If this pointer is null, nothing will be written here.
segmentIndex,
zero-based, specifies which
to
use.
lpReady,
a pointer to the
callback function
that the driver will call when the data has been collected. To use
the
polling method instead of a callback function,
set this pointer to NULL.