User Manual

Programming with the PicoScope 4000 Series54
Copyright © 2008-2011 Pico Technology Ltd. All rights reserved.ps4000pg.en
Applicability
Block mode, rapid block mode
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 data points (samples) to collect.
noOfPostTriggerSamples, the number of samples to be taken
after a trigger event. If no trigger event is set then this specifies the
maximum number of samples to be taken. If a trigger condition has
been set, this specifies the number of data points (samples) to be
taken after a trigger has fired, and the number of data points to be
collected is: -
noOfPreTriggerSamples + noOfPostTriggerSamples
timebase, a number in the range 0 to 2
30
-1. See the guide to
calculating timebase values.
oversample, the oversampling factor, a number in the range 1 to
16.
timeIndisposedMs, returns the time, in milliseconds, that the
PicoScope4000 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 ps4000BlockReady callback that the
driver will call when the data has been collected. To use the
ps4000IsReady polling method instead of a callback function, set
this pointer to NULL.
pParameter, a void pointer that is passed to the
ps4000BlockReady callback function. The callback can use the
pointer to return arbitrary data to your application.
Returns
PICO_OK
PICO_INVALID_HANDLE
PICO_USER_CALLBACK
PICO_SEGMENT_OUT_OF_RANGE
PICO_INVALID_CHANNEL
PICO_INVALID_TRIGGER_CHANNEL
PICO_INVALID_CONDITION_CHANNEL
PICO_TOO_MANY_SAMPLES
PICO_INVALID_TIMEBASE
PICO_NOT_RESPONDING
PICO_CONFIG_FAIL
PICO_INVALID_PARAMETER
PICO_NOT_RESPONDING
PICO_TRIGGER_ERROR