Agilent Technologies E1439 manual Age1439attribget, Description

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

74