RFmxWcdmaMXAcpResults.FetchCarrierMeasurement Method
- Updated2024-07-17
- 2 minute(s) read
RFmx
Fetches the absolute and relative powers of the carrier. The relative power is relative to the total carrier power.
Use "carrier(n)" as the selector string to configure this method.
Use "carrier(n)" as the selector string to configure this method.
Namespace: NationalInstruments.RFmx.WcdmaMX
Assembly: NationalInstruments.RFmx.WcdmaMX.Fx40 (in NationalInstruments.RFmx.WcdmaMX.Fx40.dll) Version: 24.5.0.49286 (24.5.0.49286)
Syntax
public int FetchCarrierMeasurement( string selectorString, double timeout, out double absolutePower, out double relativePower )
Public Function FetchCarrierMeasurement ( selectorString As String, timeout As Double, <OutAttribute> ByRef absolutePower As Double, <OutAttribute> ByRef relativePower As Double ) As Integer
Parameters
- selectorString String
-
Specifies a selector string comprising of the result name, and carrier number. If you do not specify the result name, the default result instance is used.
Example:
"carrier0"
"result::r1/carrier0"
You can use the BuildCarrierString(String, Int32) method to build the selector string. - timeout Double
- Specifies the time for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete.
- absolutePower Double
-
Upon return, contains the carrier power.
The carrier power is the integrated power of the RRC-filtered signal. The RRC filter uses a bandwidth of 3.84 MHz with a roll-off factor of 0.22. The carrier is centered at a frequency determined by the Center Frequency and SetCarrierFrequency(String, Double) methods.
This value is expressed in dBm.
- relativePower Double
-
Upon return, contains the carrier power relative to the total carrier power. This value is expressed in dB.
Return Value
Int32Returns the status code of this method. The status code either indicates success or describes a warning condition.