FetchTotalCarrierPower(string, double, out double)
- Updated2025-10-13
- 1 minute(s) read
Fetches the total integrated power, in dBm, of all the enabled carriers measured when you set the SetPowerUnits(string, RFmxSpecAnMXSemPowerUnits) method to dBm. Gets the power spectral density, in dBm/Hz, when you set the SetPowerUnits(string, RFmxSpecAnMXSemPowerUnits) method to dBmPerHertz.
Syntax
Namespace: NationalInstruments.RFmx.SpecAnMX
public int FetchTotalCarrierPower(string selectorString, double timeout, out double totalCarrierPower)
Remarks
This method maps to the RFmxSpecAn_SEMFetchTotalCarrierPower() function in C.
Parameters
| Name | Type | Description |
|---|---|---|
| selectorString | string | Specifies the result name. Example: "", "result::r1". You can use the BuildResultString(string) 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. |
| totalCarrierPower | out double | Upon return, contains the total integrated power, in dBm, of all the active carriers measured when you set the SetPowerUnits(string, RFmxSpecAnMXSemPowerUnits) method to dBm. Upon return, contains the power spectral density, in dBm/Hz, when you set the SetPowerUnits(string, RFmxSpecAnMXSemPowerUnits) method to dBmPerHertz. |
Returns
Returns the status code of this method. The status code either indicates success or describes an error or warning condition.