User Manual

Programming with the PicoScope 4000 Series36

4.10.17

ps4000GetValuesAsync

PICO_STATUS ps4000GetValuesAsync

(

short handle,

unsigned long startIndex,

unsigned long noOfSamples,

unsigned long downSampleRatio,

short downSampleRatioMode,

unsigned short segmentIndex,

void * lpDataReady,

void * pParameter

)

This function returns streaming data, either with or without aggregation, starting at

the specified sample number. It is used to get the stored data from the scope after

data collection has stopped. It returns the data using a callback.

Applicability

Streaming mode only

Arguments

handle, the handle of the required device

startIndex, see ps4000GetValues

noOfSamples, see ps4000GetValues

downSampleRatio, see ps4000GetValues

downSampleRatioMode, see ps4000GetValues

segmentIndex, see ps4000GetValues

lpDataReady, a pointer to the ps4000StreamingReady function

that is called when the data is ready

pParameter, a void pointer that will be passed to the

ps4000StreamingReady callback function. The data type depends

on the design of the callback function, which is determined by the

application programmer.

Returns

PICO_OK

PICO_INVALID_HANDLE

PICO_NO_SAMPLES_AVAILABLE

PICO_DEVICE_SAMPLING – streaming only

PICO_NULL_PARAMETER

PICO_STARTINDEX_INVALID

PICO_SEGMENT_OUT_OF_RANGE

PICO_INVALID_PARAMETER

PICO_DATA_NOT_AVAILABLE

PICO_INVALID_SAMPLERATIO

PICO_INVALID_CALL