FetchUpperOffsetPowerArray(string, double, ref double[], ref double[], ref double[], ref double[], ref double[])
- Updated2025-04-08
- 2 minute(s) read
Returns an array of total absolute and relative powers, peak, absolute, and relative powers, and frequencies at peak absolute powers of upper offset segments. The relative power is relative to total aggregated power.
Use "subblock(n)" as the selector string to read results from this method.
Syntax
Namespace: NationalInstruments.RFmx.NRMX
public int FetchUpperOffsetPowerArray(string selectorString, double timeout, ref double[] totalAbsolutePower, ref double[] totalRelativePower, ref double[] peakAbsolutePower, ref double[] peakFrequency, ref double[] peakRelativePower)
Parameters
| Name | Type | Description |
|---|---|---|
| selectorString | string | Specifies a selector string comprising of the result name, and subblock number. If you do not specify the result name, the default result instance is used. Example: |
| 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. |
| totalAbsolutePower | ref double[] | Upon return, contains an array of the upper segment power. This value is expressed in dBm. |
| totalRelativePower | ref double[] | Upon return, contains an array of the power in the upper offset segment relative to total aggregated power. This value is expressed in dB. |
| peakAbsolutePower | ref double[] | Upon return, contains an array of the peak power in the upper offset segment. This value is expressed in dBm. |
| peakFrequency | ref double[] | Upon return, contains an array of the frequency at which the peak power occurs in the upper offset segment. This value is expressed in Hz. |
| peakRelativePower | ref double[] | Upon return, contains an array of the peak power in the upper offset segment relative to total aggregated power. 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.