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

NameTypeDescription
selectorStringstring

Specifies the result name. Example: "", "result::r1". You can use the BuildResultString(string) method to build the selector string.

timeoutdouble

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.

totalCarrierPowerout 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.