FetchUpperOffsetMargin(string, double, out RFmxNRMXSemUpperOffsetMeasurementStatus, out double, out double, out double, out double)
- Updated2025-04-08
- 2 minute(s) read
Returns the measurement status, margin, frequency at margin, absolute, and relative powers at the margin for upper offset segments. The relative power is relative to the total aggregated power.
Use "offset(n)" or "subblock(n)/offset(n)" as the selector string to read results from this method.
Syntax
Namespace: NationalInstruments.RFmx.NRMX
public int FetchUpperOffsetMargin(string selectorString, double timeout, out RFmxNRMXSemUpperOffsetMeasurementStatus measurementStatus, out double margin, out double marginFrequency, out double marginAbsolutePower, out double marginRelativePower)
Parameters
| Name | Type | Description |
|---|---|---|
| selectorString | string | Specifies a selector string comprising of the result name, subblock number, carrier number, and offset 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 | out RFmxNRMXSemUpperOffsetMeasurementStatus | Upon return, contains the measurement status indicating whether the power before and after the burst is within the standard defined limit. |
| margin | out double | Upon return, contains 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 | out double | Upon return, contains the frequency at which the margin occurs in the upper offset. This value is expressed in Hz. |
| marginAbsolutePower | out double | Upon return, contains the power at which the margin occurs in the upper offset segment. This value is expressed in dBm. |
| marginRelativePower | out double | Upon return, contains the power at which the margin occurs in the upper 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.