Agilent Technologies E1439, User Manual

Page: 191 / 246

181
Agilent E1439 Programmer's Reference
Functions listed alphabetically
age1439_trigger_delay_actual_get
Returns the actual trigger delay from the most recent trigger event.
VXI plug&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.
Note
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
id is the VXI instrument session pointer returned by the age1439_init function.
actualDelayPtr 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