Note

id

actualDelayPtr

Agilent E1439 Programmer's Reference

Functions listed alphabetically

age1439_trigger_delay_actual_get

Returns the actual trigger delay from the most recent trigger event.

VXIplug&play Syntax

#include "age1439".h

ViStatus age1439_trigger_delay_actual_get(ViSession id, ViPInt32 actualDelayPtr);

Description

This delay value provides more accuracy than the trigger delay parameter alone since it includes a measurement of the fractional part of the output sample period between the previous output sample and the actual trigger event. The trigger delay accuracy improves the delay value to one ADC sample clock period rather than one output sample period. This can result in a substantial improvement in accuracy when narrow bandwidth decimation filtering is used.

age1439_trigger_delay_actual_get must be called for each new trigger event that requires precise delay measurement. The actual delay is still expressed in ADC sample periods.

In multiple module systems, the actual delay of the triggering module should be used to correct data from other modules in the system.

Due to the way the data is packed within the module, it is possible to get values from this command that represent more than one output sample.

Parameters

is the VXI instrument session pointer returned by the age1439_init function.

points to the returned actual delay from the most recent trigger event representing the actual time from the desired trigger point to the actual trigger point.

Return Value

AGE1439_SUCCESS indicates that a function was successful.

Values other than AGE1439_SUCCESS indicate an error condition or other important status condition. To determine the error message, pass the return value to “age1439_error_message” on page 102.

See Also

“age1439_init” on page 132, “age1439_trigger_setup” on page 183, “age1439_trigger_phase_ actual_get” on page 182, “Delay and phase in triggered measurements” in chapter 3, “Trigger and phase in multi-module systems” in chapter 3

181

Page 191
Image 191
Agilent Technologies E1439 manual Age1439triggerdelayactualget, ActualDelayPtr