VISA Template Attributes

Agilent VISA.NET

VISA Template Attributes

This topic summarizes the interface that each VISA implementation must incorporate.

VISA Template Attributes

Symbolic Name

Access Privilege


Data Type


Range


Description


Default

VI_ATTR_RSRC_IMPL_VERSION

RO

Global

ViVersion

0h to FFFFFFFFh

Resource version that uniquely identifies each of the different revisions or implementations of a resource.

N/A

 

VI_ATTR_RSRC_LOCK_STATE

RO

Global

ViAccessMode

VI_NO_LOCK
VI_EXCLUSIVE_LOCK
VI_SHARED_LOCK

The current locking state of the resource. The resource can be unlocked, locked with an exclusive lock, or locked with a shared lock.

VI_NO_LOCK

 

VI_ATTR_RSRC_MANF_ID

RO

Global

ViUInt16

0h to 3FFFh

A value that corresponds to the VXI manufacturer ID of the manufacturer that created the implementation.

N/A

 

VI_ATTR_RSRC_MANF_NAME

RO

Global

ViString

N/A

A string that corresponds to the VXI manufacturer name of the manufacturer that created the implementation.

N/A

 

VI_ATTR_RSRC_NAME

RO

Global

ViRsrc

N/A

The unique identifier for a resource.

N/A

 

VI_ATTR_RSRC_SPEC_VERSION***

RO

Global

ViVersion

00500000h

Resource version that uniquely identifies the version of the VISA specification to which the implementation is compliant.

00500000h

 

VI_ATTR_RM_SESSION

RO

Local

ViSession

N/A

Specifies the session of the Resource Manager that was used to open this session.

N/A

 

VI_ATTR_MAX_QUEUE_LENGTH

R/W*

Local

ViUInt32

1h to FFFFFFFFh

Specifies the maximum number of events that can be queued at any time on the given session.

50

 

VI_ATTR_RSRC_CLASS

RO

Global

ViString

N/A

Specifies the resource class (for example, “INSTR”).

N/A

 

VI_ATTR_USER_DATA

R/W

Local

ViAddr

**

Data used privately by the application for a particular session. This data is not used by VISA for any purposes and is provided to the application for its own use.

 

VI_ATTR_USER_DATA_32

R/W

Local

ViUInt32

0h to FFFFFFFFh

 

Data used privately by the application for a particular session. This data is not used by VISA for any purposes and is provided to the application for its own use.

 

VI_ATTR_USER_DATA_64****

R/W

Local

ViUInt64

0h to FFFFFFFFFFFFFFFFh

 

Data used privately by the application for a particular session. This data is not used by VISA for any purposes and is provided to the application for its own use.

 

 * This attribute becomes RO once viEnableEvent has been called for the first time.

** Specified in the relevant VPP-4.3.x framework document.

*** The value of this attribute is a fixed value that reflects the version of the VISA specification to which the implementation is compliant. This value will change with subsequent versions of the specification.

**** Defined only for frameworks that are 64-bit native.

VISA Template Operations

viClose(vi)
viGetAttribute(vi, attribute, attrState)
viSetAttribute(vi, attribute, attrState)
viStatusDesc(vi, status, desc)
viTerminate(vi, degree, jobId)
viLock(vi, lockType, timeout, requestedKey, accessKey)
viUnlock(vi)
viEnableEvent(vi, eventType, mechanism, context)
viDisableEvent(vi, eventType, mechanism)
viDiscardEvents(vi, eventType, mechanism)
viWaitOnEvent(vi, inEventType, timeout, outEventType, outContext)
viInstallHandler(vi, eventType, handler, userHandle)
viUninstallHandler(vi, eventType, handler, userHandle)