User`s guide

4-144 Agilent E6432A Microwave Synthesizer User’s Guide

HPE6432_reset

ViStatus HPE6432_reset (ViSession instrumentHandle);

Purpose

This function sets the entire instrument and VXIplug&play driver to

some predetermined default state. It modifies both the driver

instrument state and the actual hardware so that they match.

For security reasons, users may have the requirement that all

frequency information be erased from memory; the Reset function

when used in conjunction with ClearList can be used for this purpose.

Only non-volatile memory is used for calibration data; all other memory

is completely purged when power is turned off. If external calibration

data is considered confidential, use the HPE6432_ResetExtDetCalData

function to load the factory-preset values.

Since lists can be saved to a file, the user will have to take

responsibility to manage the file system to ensure security.

Parameter List

instrumentHandle

Variable Type ViSession

This is the ViSession handle that is obtained from the Initialize

function. The instrumentHandle identifies a particular instrument

session.

Return Value

This return value reports the status of the Reset function.

To obtain further information about the status that is returned, call the

HPE6432_error_message function or refer to “Error-Code and

Fail-Code Messages” on page 3-93.