User`s guide

Agilent E6432A Microwave Synthesizer User’s Guide 4-9
}
} while (--findCount > 0
&& (status = viFindNext(findList,
(ViChar)&DeviceName))
== VI_SUCCESS);
}
viClose(dSession);
}
Opening an Instrument Session
To program the instrument using its VXIplug&play driver, a
communication path between the computer/controller and the
instrument must be opened. This path is known as an instrument
session and is opened with the function:
ViStatus HPE6432_init (ViRsrc resourceName, ViBoolean
idQuery, ViBoolean reset, ViSession *instrumentHandle);
Instruments within a VXIplug&play program 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 driver functions.
The parameters of the function HPE6432_init include:
ViRsrc resourceName – This parameter defines the address of the
instrument.
ViBoolean idQuery – This parameter is a Boolean flag which
indicates if in-system verification should be performed. Passing
VI_TRUE (1) will perform an in-system verification, and passing
VI_FALSE (0) will also.
ViBoolean reset – This parameter is 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, and
passing VI_FALSE (0) will not perform a reset.
ViSession *instrumentHandle – This parameter is a pointer to an
instrument session, and is the handle which addresses the instrument.
It is the first parameter passed in all other driver functions.
Successful completion of this function returns VI_SUCCESS.