RFmxWcdmaMXSemResults.FetchUpperOffsetMarginArray Method
- Updated2024-07-17
- 2 minute(s) read
RFmx
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.
Namespace: NationalInstruments.RFmx.WcdmaMX
Assembly: NationalInstruments.RFmx.WcdmaMX.Fx40 (in NationalInstruments.RFmx.WcdmaMX.Fx40.dll) Version: 24.5.0.49286 (24.5.0.49286)
Syntax
public int FetchUpperOffsetMarginArray( string selectorString, double timeout, ref RFmxWcdmaMXSemUpperOffsetMeasurementStatus[] measurementStatus, ref double[] margin, ref double[] marginFrequency, ref double[] marginAbsolutePower, ref double[] marginRelativePower )
Public Function FetchUpperOffsetMarginArray ( selectorString As String, timeout As Double, ByRef measurementStatus As RFmxWcdmaMXSemUpperOffsetMeasurementStatus(), ByRef margin As Double(), ByRef marginFrequency As Double(), ByRef marginAbsolutePower As Double(), ByRef marginRelativePower As Double() ) As Integer
Parameters
- selectorString String
-
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. - timeout Double
- 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.
- measurementStatus RFmxWcdmaMXSemUpperOffsetMeasurementStatus
-
Upon return, contains an array of measurement status values based on the values of the GetUpperOffsetMargin(String, Double) method corresponding to each upper offset segment.
- margin Double
-
Upon return, contains an array of margins of the upper offset segments.
- marginFrequency Double
-
Upon return, contains an array of frequencies corresponding to the SEM Results Upper Offset Margin method. This value is expressed in Hz.
- marginAbsolutePower 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.
- marginRelativePower 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, Double) method. This value is expressed in dB.
Return Value
Int32Returns the status code of this method. The status code either indicates success or describes a warning condition.