Sets the attenuation, in dB, of a switch (or cable) connected to the RF IN connector of the RF signal analyzer.

Syntax

Namespace: NationalInstruments.RFmx.SpecAnMX

public int SetExternalAttenuation(string selectorString, double value)

Remarks

When you set this method and set the RF Attenuation and IF Attenuation values, the appropriate attenuator settings are calculated based on ConfigureExternalAttenuation(string, double) and ConfigureReferenceLevel(string, double) values. In this case, RFmxSpecAn interprets the reference level as the maximum expected power level of the signal at the input of the external gain device. For more information about attenuation, refer to the Attenuation and Signal Levels topic for your device in the NI RF Vector Signal Analyzers Help. This method maps to the RFmxSpecAn_SetExternalAttenuation() function in C.

Parameters

NameTypeDescription
selectorStringstring

Pass an empty string. The signal name that is passed when creating the signal configuration is used.

valuedouble

Specifies the attenuation, in dB.

Returns

Returns the status code of this method. The status code either indicates success or describes an error or warning condition.