RFmxWLAN_CfgExternalAttenuation
- Updated2024-10-14
- 1 minute(s) read
RFmxWLAN_CfgExternalAttenuation
int32 __stdcall RFmxWLAN_CfgExternalAttenuation (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 externalAttenuation);
Purpose
Specifies the attenuation of a switch (or cable) connected to the RF IN connector of the signal analyzer. On a MIMO session, use port::(deviceName)/(channelNumber) as a selector string to configure external attenuation for each port.
Parameters
| Input | ||
| Name | Type | Description |
| instrumentHandle | niRFmxInstrHandle | Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxWLAN_Initialize function. |
| selectorString | char[] | Specifies a selector string comprising of the signal name and port string. If you do not specify the signal name, the default signal instance is used. Example: "" "signal::sig1" "port::myrfsa1/0" "signal::sig1/port::myrfsa1/0" You can use the RFmxWLAN_BuildSignalString function to build the selector string. On a MIMO session, you can use the RFmxInstr_BuildPortString function to build the selector string. |
| externalAttenuation | float64 | Specifies the attenuation of a switch (or cable) connected to the RF IN connector of the signal analyzer. This value is expressed in dB. For more information about attenuation, refer to the Attenuation and Signal Levels topic for your device in the NI RF Vector Signal Analyzers Help. |
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 condition. 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 RFmxWLAN_GetError function. The general meaning of the status code is as follows:
|
||||||||