DIChannelCollection.CreateChannel Method
- Updated2023-02-21
- 2 minute(s) read
DIChannelCollectionCreateChannel Method
Namespace: NationalInstruments.DAQmx
Assembly: NationalInstruments.DAQmx (in NationalInstruments.DAQmx.dll) Version: 20.7.40.49302
Syntax
public DIChannel CreateChannel( string lines, string nameToAssign, ChannelLineGrouping grouping )
Public Function CreateChannel ( lines As String, nameToAssign As String, grouping As ChannelLineGrouping ) As DIChannel
Parameters
- lines
- Type: SystemString
The names of the digital lines or ports to use to create the virtual channel. - nameToAssign
- Type: SystemString
The name of the virtual channel this method creates. - grouping
- Type: NationalInstruments.DAQmxChannelLineGrouping
The grouping of digital lines into one or more DIChannel objects. If you specify one or more entire ports with lines, you must set grouping to OneChannelForAllLines.
Return Value
Type: DIChannelThe newly created DIChannel.
Exceptions
| Exception | Condition |
|---|---|
| DaqException | The NI-DAQmx driver returned an error. |
Remarks
If you do not specify a value for nameToAssign, NI-DAQmx uses the physical channel name for the virtual channel name. If you use nameToAssign to create a name for the local virtual channel, you must use that name when you refer to this channel in other NI-DAQmx properties and methods.
The NI-DAQmx driver does not determine if the requested settings are possible until the task is verified. CreateChannel(String, String, ChannelLineGrouping) does not throw an exception for parameter values that are not compatible with your hardware or other settings in your task. To determine if all of the settings for a Task are valid, you must verify the task by starting the task, either with Start or by reading from or writing to the task, or by calling Control(TaskAction) with Verify.