Fetches an array of measurement status values, an array of margin values, an array of frequencies at the margins, an array of the absolute power values, and an array of the relative power values at the margin frequencies for upper offset segments for the SEM measurement. The relative power is relative to the total carrier power.

Syntax

Namespace: NationalInstruments.RFmx.WcdmaMX

public int FetchUpperOffsetMarginArray(string selectorString, double timeout, ref RFmxWcdmaMXSemUpperOffsetMeasurementStatus[] measurementStatus, ref double[] margin, ref double[] marginFrequency, ref double[] marginAbsolutePower, ref double[] marginRelativePower)

Parameters

NameTypeDescription
selectorStringstring

Specifies a selector string comprising of the result name. If you do not specify the result name, the default result instance is used. Example:
""
"result::r1"
You can use the BuildResultString(string) method to build the selector string.

timeoutdouble

Specifies the time for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete.

measurementStatusref RFmxWcdmaMXSemUpperOffsetMeasurementStatus[]

Upon return, contains an array of measurement status values based on the values of the GetUpperOffsetMargin(string, out double) method corresponding to each upper offset segment.

marginref double[]

Upon return, contains an array of margins of the upper offset segments.

marginFrequencyref double[]

Upon return, contains an array of frequencies corresponding to the SEM Results Upper Offset Margin method. This value is expressed in Hz.

marginAbsolutePowerref double[]

Upon return, contains an array of powers at the frequency corresponding to the SEM Results Upper Offset Margin method. This value is expressed in dBm.

marginRelativePowerref double[]

Upon return, contains an array of powers at the frequency corresponding to the SEM Results Upper Offset Margin method, relative to the GetTotalCarrierPower(string, out double) method. 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.