RFmxInstr_CfgRFAttenuation

NI-RFmx LTE 3.0 Help

Edition Date: January 2019

Part Number: 375417G-01

»View Product Info
Download Help (Windows Only)

int32 __stdcall RFmxInstr_CfgRFAttenuation (niRFmxInstrHandle instrumentHandle, char channelName[], int32 rfAttenuationAuto, float64 rfAttenuationValue);

Purpose

Configures the nominal attenuation and the RFmx driver attenuation hardware settings.

Supported devices: NI 5663/5663E, NI 5665, NI 5668R

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxInstr_Initialize function.
channelName char[] Specifies the channel to which the settings must be applied. Specify an empty string as the value of this parameter.
rfAttenuationAuto int32 Specifies whether the RFmx driver computes the RF attenuation.
RFMXINSTR_VAL_RF_ATTENUATION_AUTO_FALSE (0)

Specifies that the RFmx driver uses the value configured using the rfAttenuationValue parameter.

RFMXINSTR_VAL_RF_ATTENUATION_AUTO_TRUE (1)

Specifies that the RFmx driver computes the RF attenuation.

rfAttenuationValue float64 Specifies the nominal attenuation setting for all attenuators that are present before the first mixer in the RF signal chain. This value is expressed in dB.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxInstr_GetError function.

The general meaning of the status code is as follows:

Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

WAS THIS ARTICLE HELPFUL?

Not Helpful