PICO PicoScope 3204 MSO, Programmer'S Manual, Page: 71 / 144

PicoScope 3000A Series Prog rammer's Guide 65
Copyright © 2011-2013 Pico Technology Limited. All rights reserved. ps3000abpg.en r9
2.12.38 ps3000aRunStreaming
PICO_STATUS ps3000aRunStreaming
(
short handle,
unsigned long * sampleInterval,
PS3000A_TIME_UNITS sampleIntervalTimeUnits,
unsigned long maxPreTriggerSamples,
unsigned long maxPostTriggerSamples,
short autoStop,
unsigned long downSampleRatio,
PS3000A_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 ps3000aGetStreamingLatestValues 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:
PS3000A_FS
PS3000A_PS
PS3000A_NS
PS3000A_US
PS3000A_MS
PS3000A_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 ps3000aGetValues
downSampleRatioMode:
see ps3000aGetValues