niDCPower_ConfigureVoltageLevelRange

ViStatus niDCPower_ConfigureVoltageLevel Range(ViSession vi, ViConstString channelName, ViReal64 range);

Purpose

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

Use the NIDCPOWER_ATTR_VOLTAGE_LEVEL_AUTORANGE attribute to enable automatic selection of the voltage level 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 level range, in volts, on the specified channel(s). Valid Values: NI PXI-4110 Channel Voltage Level Range (V) Voltage Level (V) 0 6 0 to +6 1 20 0 to +20 2 20 0 to -20 NI PXI-4130 Channel Voltage Level Range (V) Voltage Level (V) 0 6 0 to +6 1 6 -6 to +6 20 -20 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 level range on Channel 1 on the NI-PXI 4130 coerces the voltage level 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.