User Manual

PicoScope 4000 Series Programmer's Guide 39

4.10.20

ps4000GetValuesTriggerChannelTimeOffsetBulk64

PICO_STATUS ps4000GetValuesTriggerChannelTimeOffsetBulk64

(

short handle,

__int64 * times,

PS4000_TIME_UNITS * timeUnits,

unsigned short fromSegmentIndex,

unsigned short toSegmentIndex,

PS4000_CHANNEL channel

)

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

captured in rapid block mode, adjusted for the time skew relative to the trigger

source. 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.

channel, the scope channel for which information is required

Returns

PICO_OK

PICO_INVALID_HANDLE

PICO_NULL_PARAMETER

PICO_DEVICE_SAMPLING

PICO_SEGMENT_OUT_OF_RANGE

PICO_NO_SAMPLES_AVAILABLE