Installation guide

API functions40

4.21

ps4000aGetValuesAsync

PICO_STATUS ps4000aGetValuesAsync

(

int16_t handle,

uint32_t startIndex,

uint32_t noOfSamples,

uint32_t downSampleRatio,

PS4000A_RATIO_MODE downSampleRatioMode,

uint32_t segmentIndex,

void * lpDataReady,

void * pParameter

)

This function returns streaming data, either with or without downsampling, 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 ps4000aGetValues

noOfSamples, see ps4000aGetValues

downSampleRatio, see ps4000aGetValues

downSampleRatioMode, see ps4000aGetValues

segmentIndex, see ps4000aGetValues

* lpDataReady, the ps4000aStreamingReady function that is

called when the data is ready

pParameter, a void pointer that will be passed to the

ps4000aStreamingReady 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