User`s guide

4-184 Agilent E6432A Microwave Synthesizer User’s Guide

HPE6432_SetFrequency

ViStatus HPE6432_SetFrequency (ViSession instrumentHandle,

ViReal64 frequency);

Purpose

This function sets the current frequency of the output while all other

instrument states remain unchanged.

This function uses the compound frequency+power function (Set Freq,

ALC, Atten) to set the synthesizer by remembering and sending the

current value for power along with a user-specified value for frequency.

Factory Preset Value: Frequency = 10 MHz

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.

frequency

Variable Type ViReal64

This parameter specifies a frequency setting.

Valid range: 10 MHz to 20 GHz with 1 Hz resolution

Return Value

This return value reports the status of the Set Frequency 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.