Adjusts the AC voltage flatness calibration based on the frequency and voltage stimulus values generated by niDCPower_CalConfigACFlatness and the voltage measured by an external oscilloscope.

Syntax

ViStatus _VI_FUNC niDCPower_CalAdjustACFlatness(ViSession vi, ViConstString channelName, ViReal64 generatedFrequency, ViReal64 generatedVoltageRMS, ViReal64 measuredVoltageRMS, ViUInt32 *numberOfStepsRemaining)

Remarks

This function returns the number of steps remaining in the calibration procedure.

Note

This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

Parameters

NameDirectionTypeDescription
vi[in]ViSession

Identifies a particular instrument calibration session. vi is obtained from the niDCPower_InitExtCal function.

channelName[in]ViConstString

Specifies the channel to which these calibration settings apply. Only one channel at a time can be calibrated.

generatedFrequency[in]ViReal64

Specifies the generated frequency, in Hz, utilized by the oscilloscope for the present AC flatness calibration step.

generatedVoltageRMS[in]ViReal64

Specifies the RMS voltage, in volts, utilitized by the oscilloscope for the present AC flatness calibration step.

measuredVoltageRMS[in]ViReal64

Specifies the RMS voltage, in volts, measured by the oscilloscope for the present AC flatness calibration step.

numberOfStepsRemaining[out]ViUInt32 *

Returns the remaining number of steps to complete the AC flatness calibration.

Returns

Reports the status of this operation. To obtain a text description of the status code, call niDCPower_error_message. To obtain additional information concerning the error condition, call niDCPower_GetError. The general meaning of the status code is as follows:

Value

Meaning

0

Success

Positive Values

Warnings

Negative Values

Errors