User Manual

Programming with the PicoScope 4000 Series38

4.10.19

ps4000GetValuesTriggerChannelTimeOffsetBulk

PICO_STATUS ps4000GetValuesTriggerChannelTimeOffsetBulk

(

short handle,

unsigned long * timesUpper,

unsigned long * timesLower,

PS4000_TIME_UNITS * timeUnits,

unsigned short fromSegmentIndex,

unsigned short toSegmentIndex,

PS4000_CHANNEL channel

)

This function retrieves the time offset, as lower and upper 32-bit values, for a group of

waveforms obtained in rapid block mode, adjusted for the time skew relative to the

trigger source. The array size for timesUpper and timesLower 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

* timesUpper, a pointer to 32-bit integers. This will hold the

most significant 32 bits of 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.

* timesLower, a pointer to 32-bit integers. This will hold the

least-significant 32 bits of 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.

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

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

timeUnits[0] will contain the time unit for fromSegmentIndex

and the last index will contain the time unit for toSegmentIndex.

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.

channel, the channel for which the information is required.

Returns

PICO_OK

PICO_INVALID_HANDLE

PICO_NULL_PARAMETER

PICO_DEVICE_SAMPLING

PICO_SEGMENT_OUT_OF_RANGE

PICO_NO_SAMPLES_AVAILABLE