Fetches the upper offset segment power measurements.

Syntax

Namespace: NationalInstruments.RFmx.SpecAnMX

public int FetchUpperOffsetPower(string selectorString, double timeout, out double totalAbsolutePower, out double totalRelativePower, out double peakAbsolutePower, out double peakFrequency, out double peakRelativePower)

Remarks

This method maps to the RFmxSpecAn_SEMFetchUpperOffsetPower() function in C.

Parameters

NameTypeDescription
selectorStringstring

Specifies the result name and offset number. Example: "offset0", "result::r1/offset0". You can use the BuildOffsetString2(string, int) method to build the selector string.

timeoutdouble

Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete.

totalAbsolutePowerout double

Upon return, contains the upper (positive) offset segment power measured.

totalRelativePowerout double

Upon return, contains the power in the upper (positive) offset segment relative to the integrated or peak power of the reference carrier.

peakAbsolutePowerout double

Upon return, contains the peak power measured in the upper (positive) offset segment. The power is measured in dBm when you set the SetPowerUnits(string, RFmxSpecAnMXSemPowerUnits) method to dBm, and in dBm/Hz when you set the SetPowerUnits(string, RFmxSpecAnMXSemPowerUnits) method to dBmPerHertz.

peakFrequencyout double

Upon return, contains the frequency, in hertz (Hz), at which the peak power occurred in the offset segment.

peakRelativePowerout double

Upon return, contains the peak power in the upper (positive) offset segment relative to the integrated or peak power of the reference carrier.

Returns

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