AMETEK Ls Series Driver Manual - Manual (Page 162)

IVI Driver Manual Lx / Ls Series
158
ciLxs_GetAttributeViReal64
ViStatus ciLxs_GetAttributeViReal64 (ViSession instrumentHandle,
ViChar _VI_FAR channelName[],
ViAttr attributeID,
ViPReal64 attributeValue);
Purpose
This function queries the value of a ViReal64 attribute.
You can use this function to get the values of instrument- specific
attributes and inherent IVI attributes. If the attribute represents an
instrument state, this function performs instrument I/O in the following
cases:
- State caching is disabled for the entire session or for the particular
attribute.
- State caching is enabled and the currently cached value is invalid.
Parameter List
instrumentHandle
Variable Type ViSession
The ViSession handle that you obtain from the ciLxs_init or
ciLxs_InitWithOptions function. The handle identifies a particular
instrument session.
Default Value: None
channelName
Variable Type ViChar[]
If the attribute is channel-based, this control specifies the name of
the channel whose attribute is to be retrieved. If the attribute is
not channel-based, then you set this control to empty string or
VI_NULL.
Pass the virtual channel name that you assign to the instrument in
the Configuration Utility.
Virtual channel names are aliases for instrument-specific channel
strings. The instrument-specific channel strings can differ from one
instrument to another. Virtual channel names allow you to use and
swap instruments without having to change the channel names in your
source code. You assign a virtual channel name to an
instrument-specific channel through the Configuration Utility. This
control accepts virtual channel names you have assigned to the
specific instrument you are using. It also accepts the
instrument-specific channel names.