Asynchronously creates a voltage input channel or a set of voltage input channels with the specified parameters for measuring voltage.

Syntax

Namespace: NationalInstruments.ECUTS.Pulser

public async Task CreateVoltageInputChannelAsync(string channelNames, double minimumValueInVolts, double maximumValueInVolts)

Parameters

NameTypeDescription
channelNamesstring

Specifies the voltage input channel name(s) to be created.

minimumValueInVoltsdouble

Specifies the minimum value of voltage in volts that you expect the channel(s) to measure.

maximumValueInVoltsdouble

Specifies the maximum value of voltage in volts that you expect the channel(s) to measure.

Returns

CreateVoltageInputChannelAsync returns a task that represents the asynchronous operation.

Exceptions

TypeDescription
PulserSessionException

Thrown when one of the following error conditions occurs:

  • InvalidChannelName: This method is called when the specified channel name is not in the list of supported channel names.

  • InvalidChannelType: The specified channel is a current channel instead of a voltage channel.

  • InvalidInputLimitValue: The specified minimum or maximum value is not supported, or the specified minimum value is greater than the maximum value.

  • ChannelAlreadyCreated: Attempts to create a channel with a name that has already been created.

  • InvalidOperation: This method is called after configuring the acquisition time with ConfigureAcquisitionTime

  • InvalidOperation: This method is called when the Pulser is still in the Running state."/></li>
    </ul>
    </exception>
    <remarks>
    <para>
    The specified string in <paramref name="channelNames"/> can contain a list or range of the supported input channel names.
    </para>
    To specify a range of channel names, use a colon between two channel numbers or two channel names.<br/>
    Specify a number immediately before and after every colon <c>:</c> in the input string.<br/>
    Or, if a name is specified after the colon, it must be identical to the name specified immediately before the colon.<br/>
    Colons are not allowed within the individual channel name.<br/>
    The following are some of the supported <paramref name="channelNames"/> values:<br/>
    <list type="bullet">
        <item>PULSER CAPACITOR VOLTAGE 0</item>
        <item>PULSER VOLTAGE INPUT 0:2</item>
        <item>PULSER VOLTAGE INPUT 0:PULSER VOLTAGE INPUT 2</item>
    </list>
    Use commas to separate channel names and ranges in a list as follows:<br/>
    PULSER CAPACITOR VOLTAGE 0, PULSER VOLTAGE INPUT 0:1, PULSER VOLTAGE INPUT 2
    <para>
    The following channel names are supported:
    </para>
    <list type="bullet">
        <item>PULSER CAPACITOR VOLTAGE 0</item>
        <item>PULSER VOLTAGE INPUT 0</item>
        <item>PULSER VOLTAGE INPUT 1</item>
        <item>PULSER VOLTAGE INPUT 2</item>
    </list>
    <blockquote>
    If different <paramref name="minimumValueInVolts"/> and/or different <paramref name="maximumValueInVolts"/> are required
    for each channel, call this method multiple times with the required values.
    </blockquote>
    <blockquote>
    The <paramref name="minimumValueInVolts"/> and <paramref name="maximumValueInVolts"/> parameters must be within the supported range of -2000 V to 2000 V.