FetchUpperOffsetMarginArray(string, double, ref RFmxNRMXSemUpperOffsetMeasurementStatus[], ref double[], ref double[], ref double[], ref double[])
- Updated2025-10-13
- 2 minute(s) read
Returns an array of measurement status, margin, frequency at margin, absolute, and relative power at margin for upper offset segments. The relative power is relative to the total aggregated power.
Use "subblock(n)" as the selector string to read results from this method.
Syntax
Namespace: NationalInstruments.RFmx.NRMX
public int FetchUpperOffsetMarginArray(string selectorString, double timeout, ref RFmxNRMXSemUpperOffsetMeasurementStatus[] measurementStatus, ref double[] margin, ref double[] marginFrequency, ref double[] marginAbsolutePower, ref double[] marginRelativePower)
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. |
| measurementStatus | ref RFmxNRMXSemUpperOffsetMeasurementStatus[] | Upon return, contains an array of the measurement status indicating whether the power before and after the burst is within the standard defined limit. |
| margin | ref double[] | Upon return, contains an array of the margin from the absolute limit mask for upper (positive) offset. Margin is defined as the minimum difference between the spectrum and the limit mask. This value is expressed in dB. |
| marginFrequency | ref double[] | Upon return, contains an array of the frequency at which the margin occurs in the upper offset. This value is expressed in Hz. |
| marginAbsolutePower | ref double[] | Upon return, contains an array of the power at which the margin occurs in the upper offset segment. This value is expressed in dBm. |
| marginRelativePower | ref double[] | Upon return, contains an array of the power at which the margin occurs in the upper (positive) offset segment. 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.