niDCPower_ConfigureVoltageLimitRange

ViStatus niDCPower_ConfigureVoltageLimitRange (ViSession vi, ViConstString channelName, ViReal64 range);

Purpose

Configures the voltage limit range for the specified channel(s). The configured range defines the valid values the voltage limit can be set to using the niDCPower_ConfigureVoltageLimit function. The voltage limit range setting is applicable only if the channel is set to the NIDCPOWER_VAL_DC_CURRENT output function using the niDCPower_ConfigureOutputFunction function.

Use the NIDCPOWER_ATTR_VOLTAGE_LIMIT_AUTORANGE attribute to enable automatic selection of the voltage limit range.

Parameters

Input
Name	Type	Description
vi	ViSession	Identifies a particular instrument session. vi is obtained from the niDCPower_init or niDCPower_InitWithOptions function.
channelName	ViConstString	Specifies to which output channel(s) to apply this configuration value. You can specify multiple channels by using a channel list or a channel range. A channel list is a comma (,) separated sequence of channel names (e.g. 0,2 specifies channels 0 and 2). A channel range is a lower bound channel followed by a hyphen (-) or colon (:) followed by an upper bound channel (e.g. 0-2 specifies channels 0, 1, and 2). In Immediate mode, multiple output channel configurations are performed sequentially based on the order specified in this parameter.
range	ViReal64	Specifies the voltage limit range, in volts, on the specified channel(s). Valid Values: NI PXI-4110 Channel Voltage Limit Range (V) Voltage Limit (V) 0 6 0 to +6 1, 2 20 0 to +20 NI PXI-4130 Channel Voltage Limit Range (V) Voltage Limit (V) 0 6 0 to +6 1 6 0 to +6 20 0 to +20 Note   If a range other than what is listed in the preceding table is selected, it will be coerced to the next-highest range. For example, requesting the 10 V voltage limit range on Channel 1 on the NI-PXI 4130 coerces the voltage limit range to 20 V. Refer to the Ranges topic in the NI DC Power Supplies and SMUs Help for more information about coercion.

Return Value

Name	Type	Description
Status	ViStatus	Reports the status of this operation. To obtain a text description of the status code, call the niDCPower_error_message function. To obtain additional information concerning the error condition, call the niDCPower_GetError function.