Age1439_wait – Agilent Technologies VXI E1439 User Manual

Page 199

Advertising
background image

189

Agilent E1439 Programmer's Reference

Functions listed alphabetically

age1439_wait

Facilitates the synchronization and control of multi-module systems.

VXIplug&play Syntax

#include "age1439".h

ViStatus age1439_wait(ViSession id);

Description

This function assures that all slave modules are completely set up before issuing measurement
control commands to the master module. Prior to calling age1439_meas_control for the master
module in multi-module systems, you should call age1439_wait for each other module within the
related synchronous group to which you have previously sent commands.

This function polls the status register of the indicated module until the AGE1439_STATUS_
HARDWARE_SET
and AGE1439_STATUS_SYNC_COMPLETE bits are both true, or until
approximately three seconds have elapsed. The function returns AGE1439_SUCCESS
immediately after the status bits are set, or, if the time-out limit is reached, AGE1439_STATUS_
WAIT_TIMEOUT
is returned.

Parameters

id

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

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_meas_start” on page 155

,

“age1439_meas_control” on

page 151

Advertising
This manual is related to the following products: