RFmxNRMXSemResults.FetchLowerOffsetMargin Method
- Updated2024-07-17
- 2 minute(s) read
RFmxNRMXSemResultsFetchLowerOffsetMargin Method
Returns the measurement status, margin, frequency at margin, absolute, and relative powers at the margin for lower 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.
Use "offset(n)" or "subblock(n)/offset(n)" as the selector string to read results from this method.
Namespace: NationalInstruments.RFmx.NRMX
Assembly: NationalInstruments.RFmx.NRMX.Fx40 (in NationalInstruments.RFmx.NRMX.Fx40.dll) Version: 24.5.0.49283 (24.5.0.49283)
Syntax
public int FetchLowerOffsetMargin( string selectorString, double timeout, out RFmxNRMXSemLowerOffsetMeasurementStatus measurementStatus, out double margin, out double marginFrequency, out double marginAbsolutePower, out double marginRelativePower )
Public Function FetchLowerOffsetMargin ( selectorString As String, timeout As Double, <OutAttribute> ByRef measurementStatus As RFmxNRMXSemLowerOffsetMeasurementStatus, <OutAttribute> ByRef margin As Double, <OutAttribute> ByRef marginFrequency As Double, <OutAttribute> ByRef marginAbsolutePower As Double, <OutAttribute> ByRef marginRelativePower As Double ) As Integer
Parameters
- selectorString
- Type: SystemString
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:
"subblock0/offset0"
"result::r1/subblock0/offset0"
You can use the BuildOffsetString(String, Int32) method to build the selector string. - timeout
- Type: SystemDouble
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
- Type: NationalInstruments.RFmx.NRMXRFmxNRMXSemLowerOffsetMeasurementStatus
Upon return, contains the measurement status indicating whether the power before and after the burst is within the standard defined limit. - margin
- Type: SystemDouble
Upon return, contains the margin from the absolute limit mask for lower (negative) offset. Margin is defined as the minimum difference between the spectrum and the limit mask. This value is expressed in dB. - marginFrequency
- Type: SystemDouble
Upon return, contains the frequency at which the margin occurs in the lower offset. This value is expressed in Hz. - marginAbsolutePower
- Type: SystemDouble
Upon return, contains the power at which the margin occurs in the lower offset segment. This value is expressed in dBm. - marginRelativePower
- Type: SystemDouble
Upon return, contains the power at which the margin occurs in the lower offset segment. This value is expressed in dB.
Return Value
Type: Int32Returns the status code of this method. The status code either indicates success or describes a warning condition.