Age1439_Trigger_Delay_Actual_Get - Agilent Technologies E1439 User Manual

age1439_trigger_delay_actual_get

Returns the actual trigger delay from the most recent trigger event.
VXIplug&play Syntax
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
page
See Also
"age1439_init" on page
actual_get" on page
phase in multi-module systems" in chapter 3
#include "age1439".h
102.
132, "age1439_trigger_setup" on page
182, "Delay and phase in triggered measurements" in chapter
Agilent E1439 Programmer's Reference
Functions listed alphabetically
"age1439_error_message" on
183, "age1439_trigger_phase_
3, "Trigger and
181