niDCPower_ConfigurePulseCurrentLevelRange
- Updated2025-10-06
- 1 minute(s) read
Configures the pulse current level range for the specified channel(s).
Syntax
ViStatus _VI_FUNC niDCPower_ConfigurePulseCurrentLevelRange(ViSession vi, ViConstString channelName, ViReal64 range)
Remarks
The configured range defines the valid values to which you can set the pulse current level and pulse bias current level using the niDCPower_ConfigurePulseCurrentLevel and niDCPower_ConfigurePulseBiasCurrentLevel functions. The pulse current level range setting is applicable only if the channel is set to the NIDCPOWER_VAL_PULSE_CURRENT output function using the niDCPower_ConfigureOutputFunction function.
This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.
Parameters
| Name | Direction | Type | Description |
|---|---|---|---|
| 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. |
| range | [in] | ViReal64 | Specifies the pulse current level range, in amps, on the specified channel(s). For valid ranges, refer to the Ranges topic for your device in the NI DC Power Supplies and SMUs Help. |
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 |