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.

Syntax

Namespace: NationalInstruments.RFmx.GsmMX

public int FetchSwitchingResultsArray(string selectorString, double timeout, out double switchingCarrierPower, ref double[] lowerRelativePower, ref double[] upperRelativePower, ref double[] lowerAbsolutePower, ref double[] upperAbsolutePower)

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. The default is "" (empty string).
Example:
""
"result::r1"
You can use the BuildResultString(string) method to build the selector string.

timeoutdouble

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.

switchingCarrierPowerout double

Upon return, contains the switching carrier power. This value is expressed in dBm.

lowerRelativePowerref 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.

upperRelativePowerref 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.

lowerAbsolutePowerref double[]

Upon return, contains an array of absolute powers measured at the negative switching offset frequencies. This value is expressed in dBm.

upperAbsolutePowerref double[]

Upon return, contains an array of absolute powers measured at the positive switching offset frequencies. This value is expressed in dBm.

Returns

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