FetchUpperOffsetPower(string, double, out double, out double, out double, out double, out double)
- Updated2025-10-13
- 2 minute(s) read
Returns the total absolute and relative powers, peak absolute and relative powers and frequency at peak absolute power of upper offset segment. The relative power is relative to the peak power of the carrier.
Use "segment(n)/chain(k)/offset(l)" as the selector string to read results from this method.
Syntax
Namespace: NationalInstruments.RFmx.WlanMX
public int FetchUpperOffsetPower(string selectorString, double timeout, out double totalAbsolutePower, out double totalRelativePower, out double peakAbsolutePower, out double peakFrequency, out double peakRelativePower)
Parameters
| Name | Type | Description |
|---|---|---|
| selectorString | string | Specifies a selector string comprising of the result name, segment number, chain number, and offset number. Example: |
| timeout | double | Specifies the timeout 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. This value is expressed in seconds. |
| totalAbsolutePower | out double | Upon return, contains the average power of the upper (positive) offset over the bandwidth determined by the offset start and stop frequencies. This value is expressed in dBm. |
| totalRelativePower | out double | Upon return, contains the average power of the upper offset relative to the peak power of the carrier channel. This value is expressed in dB. |
| peakAbsolutePower | out double | Upon return, contains the peak power of the upper offset. This value is expressed in dBm. |
| peakFrequency | out double | Upon return, contains the frequency at which the peak power occurs in the upper offset. This value is expressed in Hz. |
| peakRelativePower | out double | Upon return, contains the peak power of the upper offset, relative to the peak power of the carrier channel. This value is expressed in dBm. |
Returns
Returns the status code of this method. The status code either indicates success or describes a warning condition.