|Download Help (Windows Only)|
int32 __stdcall RFmxInstr_SelfCalibrateRange( niRFmxInstrHandle instrumentHandle, char selectorString, int32 stepsToOmit, float64 minimumFrequency, float64 maximumFrequency, float64 minimumReferenceLevel, float64 maximumReferenceLevel );
Self-calibrates all configurations within the specified frequency and reference level limits. If there is an open session for NI-RFSG for your device, it may remain open but cannot be used while this function runs. NI recommends that no external signals are present on the RF In port while the calibration is taking place. For more information about Self Calibrate Range, refer to the niRFSA Self Calibrate Range function topic for your device in the NI RF Vector Signal Analyzers Help.
Supported devices: PXIe-5644/5645/5646, PXIe-5820/5830/5831/5840/5841
|Note This function does not update self-calibration date and temperature. Self-calibration range data is not saved to your device if you restart the system.|
|instrumentHandle||niRFmxInstrHandle||Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxInstr_Initialize function.|
|selectorString||char||Specify an empty string as the value of this parameter.
|stepsToOmit||int32||Specifies which calibration steps to skip during the self-calibration process. The default value is an empty array, which indicates that all calibration steps are performed.
|minimumFrequency||float64||Specifies the minimum frequency for the custom self calibration range. This value is expressed in Hz.
|maximumFrequency||float64||Specifies the maximum frequency for the custom self calibration range. This value is expressed in Hz.|
|minimumReferenceLevel||float64||Specifies the minimum reference level for the custom self calibration range. This value is expressed in dBm.|
|maximumReferenceLevel||float64||Specifies the maximum reference level for the custom self calibration range. This value is expressed dBm.|
|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: