DOChannelCollection.CreateChannel Method
- Updated2023-02-21
- 2 minute(s) read
DOChannelCollectionCreateChannel Method
Creates a DOChannel to generate digital signals. This method adds one or more channels to the DOChannelCollection.
Namespace: NationalInstruments.DAQmx
Assembly: NationalInstruments.DAQmx (in NationalInstruments.DAQmx.dll) Version: 20.7.40.49302
Syntax
public DOChannel CreateChannel( string lines, string nameToAssign, ChannelLineGrouping grouping )
Public Function CreateChannel ( lines As String, nameToAssign As String, grouping As ChannelLineGrouping ) As DOChannel
Parameters
- lines
- Type: SystemString
The names of the digital lines or ports to use to create the virtual channel. - nameToAssign
- Type: SystemString
One or more names to assign to the created local virtual channels. To use the physical channel name as the local virtual channel name, set this value to Empty. - grouping
- Type: NationalInstruments.DAQmxChannelLineGrouping
The grouping of digital lines into one or more DOChannel objects. If you specify one or more entire ports with lines, you must set grouping to OneChannelForAllLines.
Return Value
Type: DOChannelThe newly created DOChannel.
Exceptions
| Exception | Condition |
|---|---|
| DaqException | The NI-DAQmx driver returned an error. |
Remarks
You can group digital lines into one DOChannel or separate them into multiple DOChannel objects. If you specify one or more entire ports with lines by using port physical channel names, you cannot separate the ports into multiple channels. To separate ports into multiple channels, use this method multiple times with a different port each time.
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.