Agilent Technologies VXI E1439 - Manual (Page 84)

74
Agilent E1439 Programmer's Reference
Functions listed alphabetically
age1439_attrib_get
Gets low-level attributes of current I/O library session.
VXIplug&play Syntax
#include "age1439".h
ViStatus age1439_attrib_get(ViSession id, ViInt16 attribute, ViPint32 value);
Description
age1439_attrib_get is used primarily to manage the use of interrupts which requires making
direct VISA function calls. Since interrupts are a shared resource across all modules using the
VXI interface, it is not possible for the Agilent E1439 library, which governs single modules, to
provide the functions to properly manage interrupts.
This function is used to access either the I/O library handle or the mapped I/O base address of the
module. You should refer to the appropriate VISA documentation for descriptions of the I/O
library functions.
Parameters
id is the VXI instrument session pointer returned by the age1439_init function.
attribute designates the type of attribute to return.
AGE1439_IO_HANDLE accesses the I/O library handle.
AGE1439_IO_ADDRESS points to the mapped I/O base address of the module.
AGE1439_RM_HANDLE accesses the I/O library handle of the default resource manager.
AGE1439_DATA_REGISTER points to the mapped address of the Agilent E1439 data register.
One or both of these parameters are used when calling I/O library functions directly.
value is the value of the requested attribute. For the VISA I/O library the value of the handle attribute
corresponds to the vi parameter used by the majority of the I/O functions. The address attribute
points to the base of the mapped I/O address space.
Example
See the interrupt.c example program.
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_interrupt_setup” on page 146