Show/Hide Toolbars

Navigation: API functions

ps6000aGetValuesTriggerTimeOffsetBulk - get trigger time offsets for multiple segments

Scroll Prev Top Next More

PICO_STATUS ps6000aGetValuesTriggerTimeOffsetBulk

(

int16_t              handle,

int64_t            * times,

PICO_TIME_UNITS    * timeUnits,

uint64_t             fromSegmentIndex,

uint64_t             toSegmentIndex

)

 

This function retrieves the trigger time offset for multiple waveforms obtained in block mode or rapid block mode. It is a more efficient alternative to calling ps6000aGetTriggerTimeOffset() once for each waveform required. See ps6000aGetTriggerTimeOffset() for an explanation of trigger time offsets.

Applicability

Rapid block mode

Arguments

handle, the device identifier returned by ps6000aOpenUnit().

* times, an array of integers. On exit, the time offset for each requested segment index. times[0] will hold the fromSegmentIndex time offset and the last times[] index will hold the toSegmentIndex time offset. The array must be long enough to hold the number of requested times.

* timeUnits, an array of integers. The array must be long enough to hold the number of requested times. On exit, timeUnits[0] will contain the time unit for fromSegmentIndex and the last element will contain the time unit for toSegmentIndex. PICO_TIME_UNITS values are listed under ps6000aGetTriggerTimeOffset().

fromSegmentIndex, the first segment for which the time offset is required

toSegmentIndex, the last segment for which the time offset is required. If toSegmentIndex is less than fromSegmentIndex then the driver will wrap around from the last segment to the first.

Returns

PICO_OK

PICO_INVALID_HANDLE

PICO_NULL_PARAMETER

PICO_DEVICE_SAMPLING

PICO_SEGMENT_OUT_OF_RANGE

PICO_NO_SAMPLES_AVAILABLE

PICO_DRIVER_FUNCTION