|NI-DCPower (English | Japanese)|
ViStatus niDCPower_ConfigurePulseCurrentLevel(ViSession vi, ViConstString channelName, ViReal64 level);
Configures the pulse current level that the device attempts to generate for the specified channel(s) during the on phase of a pulse. The channel must be enabled for the specified current level to take effect.
Refer to the niDCPower_ConfigureOutputEnabled function for more information about enabling the output channel. The pulse current level setting is applicable only if the channel is set to the NIDCPOWER_VAL_PULSE_CURRENT output function using the niDCPower_ConfigureOutputEnabled function.
The device actively regulates the current at the specified level unless doing so causes a voltage drop greater than the pulse voltage limit across the channels' output terminals.
|Note This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.|
|vi||ViSession||Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithChannels function.|
|channelName||ViConstString||Specifies the output channel(s) to which this configuration value applies. Specify multiple channels by using a channel list or a channel range. A channel list is a comma (,) separated sequence of channel names (for example, 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 (for example, 0-2 specifies channels 0, 1, and 2). In the Running state, multiple output channel configurations are performed sequentially based on the order specified in this parameter.|
|level||ViReal64||Specifies the pulse current level, in amps, on the specified channel(s).|
The valid values for this parameter are defined by the pulse current level range that is configured using the niDCPower_ConfigureCurrentPulseLevelRange function.
|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.|