Agilent Technologies E1439 manual Age1439measstart

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 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 initiate a very simple measurement using

example programs provides an example of how to 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

155