Returns the measurement status, margin, margin-frequency, absolute and relative power corresponding to the margin-frequency for upper offset segment. The relative power is relative to the peak power in the carrier.
Use "segment(n)/chain(k)/offset(l)" as the selector string to read results from this method.

Syntax

Namespace: NationalInstruments.RFmx.WlanMX

public int FetchUpperOffsetMargin(string selectorString, double timeout, out RFmxWlanMXSemUpperOffsetMeasurementStatus measurementStatus, out double margin, out double marginFrequency, out double marginAbsolutePower, out double marginRelativePower)

Parameters

NameTypeDescription
selectorStringstring

Specifies a selector string comprising of the result name, segment number, chain number, and offset number. Example:
"segment0/chain0/offset0"
"result::r1/segment0/chain0/offset0"
You can use the BuildOffsetString(string, int) method to build the selector string.

timeoutdouble

Specifies the timeout 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. This value is expressed in seconds.

measurementStatusout RFmxWlanMXSemUpperOffsetMeasurementStatus

Upon return, contains the upper (positive) offset segment measurement status, indicating whether the spectrum exceeds the SEM measurement mask limits in the upper offset segment.

marginout double

Upon return, contains the margin from the SEM measurement mask for the upper offset. Margin is defined as the maximum difference between the spectrum and the mask. This value is expressed in dB.

marginFrequencyout double

Upon return, contains the frequency corresponding to the margin for the upper offset. This value is expressed in Hz.

marginAbsolutePowerout double

Upon return, contains the power level of the spectrum, corresponding to the SEM Results Upper Offset Margin result. This value is expressed in dBm.

marginRelativePowerout double

Upon return, contains the power level of the spectrum, corresponding to the GetUpperOffsetMargin(string, out double) result. The power level is returned relative to the peak power of the carrier channel. This value is expressed in dB.

Returns

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