User Manual

Programming with the PicoScope 4000 Series30

4.10.11

ps4000GetTriggerChannelTimeOffset

PICO_STATUS ps4000GetTriggerChannelTimeOffset

(

short handle,

unsigned long * timeUpper,

unsigned long * timeLower,

PS4000_TIME_UNITS * timeUnits,

unsigned short segmentIndex,

PS4000_CHANNEL channel

)

This function gets the time, as two 4-byte values, at which the trigger occurred,

adjusted for the time skew of the specified channel relative to the trigger source. Call

it after block-mode data has been captured or when data has been retrieved from a

previous block-mode capture.

Applicability

Block mode, rapid block mode

Arguments

handle, the handle of the required device

timeUpper, a pointer to the upper 32 bits of the time at which the

trigger point occurred

timeLower, a pointer to the lower 32 bits of the time at which the

trigger point occurred

timeUnits, returns the time units in which timeUpper and

timeLower are measured. The allowable values are: -

PS4000_FS: femtoseconds

PS4000_PS: picoseconds

PS4000_NS: nanoseconds

PS4000_US: microseconds

PS4000_MS: milliseconds

PS4000_S: seconds

segmentIndex, the number of the memory segment for which the

information is required.

channel,the scope channel for which the information is required

Returns

PICO_OK

PICO_INVALID_HANDLE

PICO_DEVICE_SAMPLING

PICO_SEGMENT_OUT_OF_RANGE

PICO_NULL_PARAMETER

PICO_NO_SAMPLES_AVAILABLE