User`s guide

Agilent E6432A Microwave Synthesizer User’s Guide 4-125
HPE6432_init
ViStatus HPE6432_init (ViRsrc resourceName, ViBoolean
idQuery, ViBoolean reset, ViSession *instrumentHandle);
Purpose
This function is the first function called when you access an instrument
driver. It performs the following initialization actions:
• creates a new Agilent Technologies VISA instrument driver session
• opens a session to the specified device using the interface and
address you specify for the resourceName parameter
• sends initialization commands to set the instrument to the state
necessary for the operation of the instrument driver
• if the idQuery parameter is set to VI_TRUE, the Initialize
function queries the instrument ID and checks that it is valid for this
instrument driver
• if the driver is already open by an application and the reset
parameter is set to VI_TRUE, the Initialize function resets the
instrument to a known state
if the driver is not open, a reset is always performed regardless of the
reset parameter value
• returns a ViSession instrumentHandle that you use to identify
the instrument in all subsequent instrument driver function calls
NOTE This function creates a new session each time you invoke it. Although
you can open more than one Agilent Technologies VISA session for the
same resource, it is best not to do so. You can use the same session in
multiple program threads, but you should not control the instrument
from more than one thread at a time.
Parameter List
resourceName
Variable Type ViRsrc
Pass the resourceName of the device to initialize.
Factory Preset Value: "VXI0::255::INSTR"
Factory Recommended Value: "VXI0::210::INSTR"
The recommended value shown is valid for a PCI to VXI connection
with the synthesizer set to a logical address of 210 when using Agilent
VEE.