Installation guide

PicoScope 4000 Series (A API) Programmer's Guide 55

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

-1. See the guide to

calculating timebase values.

* 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 ps4000aBlockReady callback that the

driver will call when the data has been collected. To use the

ps4000aIsReady polling method instead of a callback function, set

this pointer to NULL.

* pParameter, a void pointer that is passed to the

ps4000aBlockReady 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