User manual

ManualsBrandsPICO ManualsLaboratory Test EquipmentPC scope module Scope 6403D 350 MHz 8-channel 5 null 1 null 8 Bit Digital storage (DSO), Function generator, S

PicoScope 6000 Series Programmer's Guide 53

3.9.30

ps6000RunBlock

PICO_STATUS ps6000RunBlock

(

short handle,

unsigned long noOfPreTriggerSamples,

unsigned long noOfPostTriggerSamples,

unsigned long timebase,

short oversample,

long * timeIndisposedMs,

unsigned long segmentIndex,

ps6000BlockReady 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.

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 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

-1. See the guide to

calculating timebase values.

oversample, the oversampling factor, a number in the range 1 to

256.

* 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 ps6000BlockReady callback function

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

ps6000IsReady polling method instead of a callback function, set

this pointer to NULL.