RFmxGsmMXOrfsResults.FetchSwitchingResultsArray Method
- Updated2024-07-17
- 2 minute(s) read
RFmx
Fetches the switching carrier power, absolute powers, and relative powers measured at the switching offset frequencies. The relative powers are measured relative to the integrated switching power of the carrier.
Namespace: NationalInstruments.RFmx.GsmMX
Assembly: NationalInstruments.RFmx.GsmMX.Fx40 (in NationalInstruments.RFmx.GsmMX.Fx40.dll) Version: 24.5.0.49286 (24.5.0.49286)
Syntax
public int FetchSwitchingResultsArray( string selectorString, double timeout, out double switchingCarrierPower, ref double[] lowerRelativePower, ref double[] upperRelativePower, ref double[] lowerAbsolutePower, ref double[] upperAbsolutePower )
Public Function FetchSwitchingResultsArray ( selectorString As String, timeout As Double, <OutAttribute> ByRef switchingCarrierPower As Double, ByRef lowerRelativePower As Double(), ByRef upperRelativePower As Double(), ByRef lowerAbsolutePower As Double(), ByRef upperAbsolutePower 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. The default is "" (empty string).
Example:
""
"result::r1"
You can use the BuildResultString(String) method to build the selector string. - timeout Double
- Specifies the timeout for fetching the specified measurement. This value is expressed in seconds. 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.
- switchingCarrierPower Double
-
Upon return, contains the switching carrier power. This value is expressed in dBm.
- lowerRelativePower Double
-
Upon return, contains an array of relative powers measured at the negative switching offset frequencies. This value is expressed in dB. The relative powers are measured relative to the integrated switching power of the carrier.
- upperRelativePower Double
-
Upon return, contains an array of relative powers measured at the positive switching offset frequencies. This value is expressed in dB. The relative powers are measured relative to the integrated switching power of the carrier.
- lowerAbsolutePower Double
-
Upon return, contains an array of absolute powers measured at the negative switching offset frequencies. This value is expressed in dBm.
- upperAbsolutePower Double
-
Upon return, contains an array of absolute powers measured at the positive switching offset frequencies. This value is expressed in dBm.
Return Value
Int32Returns the status code of this method. The status code either indicates success or describes a warning condition.