FetchLowerOffsetPower(string, double, out double, out double, out double, out double, out double)
- Updated2025-10-13
- 1 minute(s) read
Fetches the lower offset segment power measurements.
Syntax
Namespace: NationalInstruments.RFmx.SpecAnMX
public int FetchLowerOffsetPower(string selectorString, double timeout, out double totalAbsolutePower, out double totalRelativePower, out double peakAbsolutePower, out double peakFrequency, out double peakRelativePower)
Remarks
This method maps to the RFmxSpecAn_SEMFetchLowerOffsetPower() function in C.
Parameters
| Name | Type | Description |
|---|---|---|
| selectorString | string | Specifies the result name and offset number. Example: "offset0", "result::r1/offset0". You can use the BuildOffsetString2(string, int) method to build the selector string. |
| timeout | double | Specifies the timeout, in seconds, for fetching the specified measurement. 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 | out double | Upon return, contains the lower (negative) offset segment power measured. |
| totalRelativePower | out double | Upon return, contains the peak power in the lower (negative) offset segment relative to the integrated or peak power of the reference carrier. |
| peakAbsolutePower | out double | Upon return, contains the peak power measured in the lower (negative) offset segment. The power is measured in dBm when you set the SetPowerUnits(string, RFmxSpecAnMXSemPowerUnits) method to dBm, and in dBm/Hz when you set the SetPowerUnits(string, RFmxSpecAnMXSemPowerUnits) method to dBmPerHertz. |
| peakFrequency | out double | Upon return, contains the frequency, in hertz (Hz), at which the peak power occurred in the offset segment. |
| peakRelativePower | out double | Upon return, contains the peak power in the lower (negative) offset segment relative to the integrated or peak power of the reference carrier. |
Returns
Returns the status code of this method. The status code either indicates success or describes an error or warning condition.