User Manual

PicoScope 4000 Series Programmer's Guide 87

4.10.59

ps4000StreamingReady

typedef void (CALLBACK *ps4000StreamingReady)

(

short handle,

long noOfSamples,

unsigned long startIndex,

short overflow,

unsigned long triggerAt,

short triggered,

short autoStop,

void * pParameter

)

This callback function is part of your application. You register it with the PicoScope

4000 series driver using ps4000GetStreamingLatestValues, and the driver calls it

back when streaming-mode data is ready. You can then download the data using the

ps4000GetValuesAsync function.

Applicability

Streaming mode only

Arguments

handle, the handle of the device returning the samples.

noOfSamples, the number of samples to collect.

startIndex, an index to the first valid sample in the buffer. This

is the buffer that was previously passed to ps4000SetDataBuffer.

overflow, returns a set of flags that indicate whether an

overvoltage has occurred on any of the channels. It is a bit pattern

with bit 0 denoting Channel A and bit 1 Channel B.

triggerAt, an index to the buffer indicating the location of the

trigger point. This parameter is valid only when triggered is non-

zero.

triggered, a flag indicating whether a trigger occurred. If non-

zero, a trigger occurred at the location indicated by triggerAt.

autoStop, the flag that was set in the call to

ps4000RunStreaming.

pParameter, a void pointer passed from

ps4000GetStreamingLatestValues. The callback function can

write to this location to send any data, such as a status flag, back to

the application.

Returns

nothing