Agilent Technologies E1439, User Manual

Page: 165 / 246

155
Agilent E1439 Programmer's Reference
Functions listed alphabetically
age1439_meas_start
Checks for valid hardware setup and then initiates a measurement.
VXI plug&play Syntax
#include "age1439".h
ViStatus age1439_meas_start(ViSession id );
Description
age1439_meas_start provides an easy way to initiate a measurement in a single module system.
This command waits for a valid hardware setup, then, if the instrument is in a valid state, performs
the equivalent of
age1439_meas_init .
Parameters
id is the VXI instrument session pointer returned by the age1439_init function.
Comments
See “The measurement loop” in chapter 3 for details on how a measurement progresses through
the four states.
This function performs the following sequence:
1. Waits for AGE1439_STATUS_HARDWARE_SET bit to be set.
2. Returns AGE1439_START_ERROR if more than three seconds elapses in step 1.
3. Returns AGE1439_SETUP_ERROR if AGE1439_STATUS_SETUP_ERROR was
detected in step 1.
4. Performs age1439_meas_init and returns AGE1439_SUCCESS.
Example
The program acvolts.exe described in the example programs provides an example of how to
initiate a very simple measurement using
age1439_meas_start .
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
“Commands which halt active measurements” on page 198 , “age1439_meas_control” on
page 151 , “age1439_meas_init” on page 154 , “age1439_status_get” on page 176 , “age1439_
read” on page 159 , “The measurement loop” in chapter 3