Age1439_meas_start – Agilent Technologies VXI E1439 User Manual
Page 165

155
Agilent E1439 Programmer's Reference
Functions listed alphabetically
age1439_meas_start
Checks for valid hardware setup and then initiates a measurement.
VXIplug&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
.
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
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
.
See Also
“Commands which halt active measurements” on page 198
,
,
“age1439_meas_init” on page 154
,
“age1439_status_get” on page 176
,
,