User Manual

PicoScope 4000 Series Programmer's Guide 41

4.10.22

ps4000GetValuesTriggerTimeOffsetBulk64

PICO_STATUS ps4000GetValuesTriggerTimeOffsetBulk64

(

short handle,

__int64 * times,

PS4000_TIME_UNITS * timeUnits,

unsigned short fromSegmentIndex,

unsigned short toSegmentIndex

)

This function retrieves the time offset, as a 64-bit integer, for a group of waveforms

captured in rapid block mode. The array size of times must be greater than or equal

to the number of waveform time offsets requested. The segment indexes are

inclusive.

Applicability

Rapid block mode

Arguments

handle, the handle of the device

* times, a pointer to 64-bit integers. This will hold the time offset

for each requested segment index. times[0] will hold the time

offset for fromSegmentIndex, and the last times index will hold

the time offset for toSegmentIndex.

* timeUnits, a pointer to a range of PS4000_TIME_UNITS. This

must be equal or larger than the number of requested times.

timeUnits[0] will contain the time unit for fromSegmentIndex,

and the last index will contain the toSegmentIndex.

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

required. The result will be placed in times[0] and timeUnits[0].

toSegmentIndex, the last segment for which the time offset is

required. The result will be placed in the last elements of the times

and timeUnits arrays. 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