User Manual

Programming with the PicoScope 4000 Series22

4.10.3

ps4000DataReady

typedef void (CALLBACK *ps4000DataReady)

(

short handle,

long noOfSamples,

short overflow,

unsigned long triggerAt,

short triggered,

void * pParameter

)

This function handles post-collection data returned by the driver after a call to

ps4000GetValuesAsync. It is a callback function that is part of your application.

You register it with the PicoScope 4000 series driver using ps4000GetValuesAsync,

and the driver calls it back when the data is ready.

Applicability

All modes

Arguments

handle, the handle of the device returning the samples.

noOfSamples, the number of samples collected.

overflow, returns a flag that indicates 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.

pParameter, a void pointer passed from ps4000GetValuesAsync

. The callback function can write to this location to send any data,

such as a status flag, back to the application. The data type is

defined by the application programmer.

Returns

nothing