Configures the pulse bias voltage limit for the specified channel(s). A channel must be enabled for the specified voltage limit to take effect.

Syntax

ViStatus _VI_FUNC niDCPower_ConfigurePulseBiasVoltageLimit(ViSession vi, ViConstString channelName, ViReal64 limit)

Remarks

Refer to the niDCPower_ConfigureOutputEnabled function for more information about enabling the channel. The pulse bias voltage limit is the voltage that the output must not exceed when generating the desired pulse bias current level (NIDCPOWER_ATTR_PULSE_BIAS_CURRENT_LEVEL). The pulse bias voltage limit setting is only applicable if the channel is set to the NIDCPOWER_VAL_PULSE_CURRENT output function using the niDCPower_ConfigureOutputFunction function.

Note

NI-DCPower uses the terms "source" and "output". However, while sinking with electronic loads and SMUs these correspond to "sinking" and "input", respectively.

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 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.

limit[in]ViReal64

Specifies the pulse bias voltage limit, in volts, on the specified channel(s). The limit is specified as a positive value, but symmetric positive and negative limits are enforced simultaneously.

Valid Values:
The valid values for this parameter are defined by the pulse voltage limit range that is configured using the niDCPower_ConfigurePulseVoltageLimitRange function.

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