DIChannel Class
- Updated2023-02-21
- 7 minute(s) read
DIChannel Class
Encapsulates one or more digital input channels and the properties for a digital input channel.
Inheritance Hierarchy
SystemObject
SystemMarshalByRefObject
NationalInstruments.DAQmxChannel
NationalInstruments.DAQmxDIChannel
SystemMarshalByRefObject
NationalInstruments.DAQmxChannel
NationalInstruments.DAQmxDIChannel
Namespace: NationalInstruments.DAQmx
Assembly: NationalInstruments.DAQmx (in NationalInstruments.DAQmx.dll) Version: 20.7.40.49302
Syntax
public class DIChannel : Channel, IFilteredTypeDescriptor
Public Class DIChannel Inherits Channel Implements IFilteredTypeDescriptor
The DIChannel type exposes the following members.
Properties
| Name | Description | |
|---|---|---|
 | AcquireOn | Specifies on which edge of the sample clock to acquire samples. |
| DataTransferMechanism | Specifies the data transfer mode for the device. |
| DataTransferRequestCondition | Specifies under what condition to transfer data from the onboard memory of the device to the buffer. |
| Description | Specifies a user-defined description for the channel. (Inherited from Channel.) |
| DigitalFilterEnable | Specifies whether to enable the digital filter for the line(s) or port(s). You can enable the filter on a line-by-line basis. You do not have to enable the filter for all lines in a channel. |
| DigitalFilterEnableBusMode | Specifies whether to enable bus mode for digital filtering. If you set this property to , NI-DAQmx treats all lines that use common filtering settings as a bus. If any line in the bus has jitter, all lines in the bus hold state until the entire bus stabilizes, or until 2 times the minimum pulse width elapses. If you set this property to , NI-DAQmx filters all lines individually. Jitter in one line does not affect other lines. |
| DigitalFilterMinimumPulseWidth | Specifies in seconds the minimum pulse width the filter recognizes as a valid high or low state transition. |
| DigitalFilterTimebaseRate | Specifies in hertz the rate of the digital filter timebase. NI-DAQmx uses this value to compute settings for the filter. |
| DigitalFilterTimebaseSource | Specifies the terminal of the signal to use as the timebase of the digital filter. |
| DigitalSynchronizationEnable | Specifies whether to synchronize recognition of transitions in the signal to the internal timebase of the device. |
| InvertLines | Specifies whether to invert the lines in the channel. If you set this property to , the lines are at high logic when off and at low logic when on. |
| IsGlobal | Indicates whether the channel is a global channel. (Inherited from Channel.) |
| LogicFamily | Specifies the logic family to use for acquisition. A logic family corresponds to voltage thresholds that are compatible with a group of voltage standards. Refer to the device documentation for information on the logic high and logic low voltages for these logic families. |
| MemoryMappingEnable | Specifies for NI-DAQmx to map hardware registers to the memory space of the application, if possible. Normally, NI-DAQmx maps hardware registers to memory accessible only to the kernel. Mapping the registers to the memory space of the application increases performance. However, if the application accesses the memory space mapped to the registers, it can adversely affect the operation of the device and possibly result in a system crash. |
| NumberOfLines | Indicates the number of digital lines in the channel. |
| PhysicalName | Specifies the name of the physical channel upon which this virtual channel is based. (Inherited from Channel.) |
| SynchronizationUnlockBehavior | Specifies the action to take if the target loses its synchronization to the grand master. (Inherited from Channel.) |
| Tristate | Specifies whether to tristate the lines in the channel. If you set this property to , NI-DAQmx tristates the lines in the channel. If you set this property to , NI-DAQmx does not modify the configuration of the lines even if the lines were previously tristated. Set this property to to read lines in other tasks or to read output-only lines. |
| Type | Indicates the type of the virtual channel. (Inherited from Channel.) |
| UsbTransferRequestCount | Specifies the maximum number of simultaneous USB transfers used to stream data. Modify this value to affect performance under different combinations of operating system and device. |
| UsbTransferRequestSize | Specifies the maximum size of a USB transfer request in bytes. Modify this value to affect performance under different combinations of operating system and device. |
| VirtualName | Gets the name of the virtual channel. (Inherited from Channel.) |
Methods
| Name | Description | |
|---|---|---|
 | CreateObjRef | Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.) |
| Dispose | Releases all resources used by Channel. (Inherited from Channel.) |
 | Dispose(Boolean) |
Releases the managed and unmanaged resources used by Channel or optionally releases only the unmanaged resources.
(Inherited from Channel.) |
| Equals | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
| GetLifetimeService | Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| InitializeLifetimeService | Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| MemberwiseClone(Boolean) | Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.) |
| ToString | Returns a string representation of the object. (Inherited from Channel.) |
Remarks
Use the DIChannels property to create or access a digital input channel. A DIChannel might contain more than one virtual channel because the DIChannel is defined by providing a valid NI-DAQmx channel string to the DIChannels indexer or to a DIChannelCollection create channel method. If you set a property on a DIChannel object that represents multiple channels, that property is set for all of the channels that the object represents.
 Tip |
|---|
| Example applications are located in the Public Documents\National Instruments\NI-DAQ\Examples\DotNET4.x directory or in the Start menu at National InstrumentsNI-DAQmxNI-DAQmx Examples. |
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.