Agilent Technologies VXI E1439 - Manual (Page 166)

156
Agilent E1439 Programmer's Reference
Functions listed alphabetically
age1439_meas_status_get
Returns the current measurement status.
VXIplug&play Syntax
#include "age1439".h
ViStatus age1439_meas_status_get(ViSession id, ViPInt16 readValid, ViPInt16 blockReady,
ViPInt16 overload);
Description
This function is useful in determining the measurement status of a module when using the fiber
interface. The advantage of using this function over
age1439_status_get , is that this function
decodes the measurement-related status register bits. This function returns the current
measurement status, which is represented by one of the four following values that are encoded in
the bottom two bits of the status register:
Parameters
id is the VXI instrument session pointer returned by the age1439_init function.
readValid returns the state of the AGE1439_STATUS_READ_VALID status register bit.
blockReady returns the state of the AGE1439_STATUS_BLOCK_READY status register bit.
overload returns the state of the AGE1439_STATUS_OVERLOAD status register bit.
Return Value
The return value of this function is the current measurement status, as represented by one of four
numeric values that are encoded in the bottom two bits of the status register shown in the table
above.
See Also
“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
Status Bit Definition Values
0-1 AGE1439_STATUS_MEAS_ARM_WAIT
AGE1439_STATUS_MEAS_IDLE
AGE1439_STATUS_MEAS_IN_PROGRESS
AGE1439_STATUS_MEAS_TRIG_WAIT AGE1439_NO_DATA_WAITING_FOR_ARM
AGE1439_NO_DATA_MEASUREMENT_PAUSED
AGE1439_NO_DATA_MEASUREMENT_IN_PROGRESS
AGE1439_NO_DATA_WAITING_FOR_TRIGGER