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 block mode. For a step-by-step guide to this
process, see Using block mode.
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 segment referred to by segmentIndex.
Block mode, rapid block mode
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: -
noOfPreTriggerSamples + noOfPostTriggerSamples
timebase, a number in the range 0 to 2
32
-1. See the guide to
calculating timebase values.
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 memory segment to
use.
lpReady, a pointer to the ps3000aBlockReady callback function
that the driver will call when the data has been collected. To use
the ps3000aIsReady polling method instead of a callback function,
set this pointer to NULL.