Configures either the voltage level range or the current limit range. If range type is Voltage, the voltage level range is configured. If range type is Current, the current limit range is configured.

Syntax

ViStatus _VI_FUNC niDCPower_ConfigureOutputRange(ViSession vi, ViConstString channelName, ViInt32 rangeType, ViReal64 range)

Remarks

This function does not configure any of the DC Current output function settings. Refer to the niDCPower_ConfigureOutputFunction function for more information.

This is a deprecated function. You must use the following functions instead of theniDCPower_ConfigureOutputRange function:

Parameters

NameDirectionTypeDescription
vi[in]ViSession

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

channelName[in]ViConstString

Specifies the channel(s) to use. Specify the channel(s) using the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3 or PXI1Slot3/0,PXI1Slot3/2:3,PXI1Slot4/2:3, where PXI1Slot3 and PXI1Slot4 are instrument resource names and 0, 2, and 3 are channels.

If you pass "" for this control, all channels in the session are used.

rangeType[in]ViInt32

Specifies the type of the range: voltage or current.

Defined Values:

Name

Value

Description

NIDCPOWER_VAL_RANGE_CURRENT

0 (0x0)

NI-DCPower configures the current range.

NIDCPOWER_VAL_RANGE_VOLTAGE

1 (0x1)

NI-DCPower configures the voltage range.

range[in]ViReal64

Specifies the range to calibrate with these settings. Only one channel at a time may be calibrated.

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