User manual

PicoScope 6000 Series Programmer's Guide 55

3.9.31

ps6000RunStreaming

PICO_STATUS ps6000RunStreaming

(

short handle,

unsigned long * sampleInterval,

PS6000_TIME_UNITS sampleIntervalTimeUnits

unsigned long maxPreTriggerSamples,

unsigned long maxPostTriggerSamples,

short autoStop,

unsigned long downSampleRatio,

PS6000_RATIO_MODE downSampleRatioMode,

unsigned long overviewBufferSize

)

This function tells the oscilloscope to start collecting data in streaming mode. When

data has been collected from the device it is downsampled if necessary and then

delivered to the application. Call ps6000GetStreamingLatestValues to retrieve the

data. See Using streaming mode for a step-by-step guide to this process.

When a trigger is set, the total number of samples stored in the driver is the sum of

maxPreTriggerSamples and maxPostTriggerSamples. If autoStop is false then

this will become the maximum number of samples without downsampling.

Applicability

Streaming mode

Arguments

handle, the handle of the required device.

* sampleInterval, on entry, the requested time interval

between samples; on exit, the actual time interval used.

sampleIntervalTimeUnits, the unit of time used for

sampleInterval. Use one of these values:

PS6000_FS

PS6000_PS

PS6000_NS

PS6000_US

PS6000_MS

PS6000_S

maxPreTriggerSamples, the maximum number of raw samples

before a trigger event for each enabled channel. If no trigger

condition is set this argument is ignored.

maxPostTriggerSamples, the maximum number of raw samples

after a trigger event for each enabled channel. If no trigger condition

is set, this argument states the maximum number of samples to be

stored.

autoStop, a flag that specifies if the streaming should stop when

all of maxSamples have been captured.

downSampleRatio: see ps6000GetValues

downSampleRatioMode: see ps6000GetValues