The HP 816x VXIplug&play Instrument Driver
158
Instruments are assigned a handle when the instrument session is opened. The
handle, which is a pointer to the instrument, is the first parameter passed in all
subsequent calls to driver functions.
The parameters of the function
• ViRsrc InstrDesc: the address of the instrument
• ViBoolean id_query: a Boolean flag which indicates if in-system
verification should be performed.
Passing VI_TRUE (1) will perform an in-system verification; passing
VI_FALSE (0) will not.
If you set id_query to false, you can use the generic functions of the
instrument driver with other instruments.
• ViBoolean reset: a Boolean flag which indicates if the instrument should
be reset when it is opened.
Passing VI_TRUE (1) will perform a reset when the session is opened;
passing VI_FALSE (0) will not perform a reset,
• ViPSession instrumentHandle: a pointer to an instrument session.
InstrumentHandle is the handle which addresses the instrument, and is
the first parameter passed in all driver functions.
Successful completion of this function returns VI_SUCCESS
Closing an Instrument Session
Sessions (instrumentHandle) opened with the hp816x_init() function are
closed with the function:
hp816x_close( ViSession instrumentHandle);
When no further communication with an instrument is required, the session must
be explicitly closed (hp816x_close() function).
VISA does not remove sessions unless they are explicitly closed. Closing the
instrument session frees all data structures and system resources allocated to that
session.
HP 8163A Lightwave Multimeter, HP 8164A Lightwave Measurement System,
& HP 8166A Lightwave Multichannel System User's Guide, E1299
Closing an Instrument Session
hp816x
_init include: