Product DocumentationNI-DAQmx .NET Framework 4.0 API ReferenceAIChannel Class

AIChannel Class

Download PDF

Updated2023-02-21
32 minute(s) read

AIChannel Class

Encapsulates one or more analog input virtual channels and the properties for an analog input virtual channel.

Inheritance Hierarchy

SystemObject
  SystemMarshalByRefObject
    NationalInstruments.DAQmxChannel
      NationalInstruments.DAQmxAIChannel

Namespace: NationalInstruments.DAQmx
Assembly: NationalInstruments.DAQmx (in NationalInstruments.DAQmx.dll) Version: 20.7.40.49302

Syntax

public class AIChannel : Channel, IFilteredTypeDescriptor

Public Class AIChannel
	Inherits Channel
	Implements IFilteredTypeDescriptor

The AIChannel type exposes the following members.

Properties

	Name	Description
	AccelerationChargeSensitivity	Specifies the sensitivity of the charge acceleration sensor connected to the channel. This value is the units you specify with AI.Accel.Charge.SensitivityUnits. Refer to the sensor documentation to determine this value.
	AccelerationChargeSensitivityUnits	Specifies the units of AI.Accel.Charge.Sensitivity.
	AccelerationDecibelReference	Specifies the decibel reference level in the units of the channel. When you read samples as a waveform, the decibel reference level is included in the waveform attributes.
	AccelerationFourWireDCVoltageSensitivity	Specifies the sensitivity of the 4 wire DC voltage acceleration sensor connected to the channel. This value is the units you specify with AI.Accel.4WireDCVoltage.SensitivityUnits. Refer to the sensor documentation to determine this value.
	AccelerationFourWireDCVoltageSensitivityUnits	Specifies the units of AI.Accel.4WireDCVoltage.Sensitivity.
	AccelerationUnits	Specifies the units to use to return acceleration measurements from the channel.
	AccelerometerSensitivity	Specifies the sensitivity of the accelerometer. This value is in the units you specify with AccelerometerSensitivityUnits. Refer to the sensor documentation to determine this value.
	AccelerometerSensitivityUnits	Specifies the units of AccelerometerSensitivity.
	ACExcitationFrequency	Specifies the AC excitation frequency in Hertz.
	ACExcitationSyncEnable	Specifies whether to synchronize the AC excitation source of the channel to that of another channel. Synchronize the excitation sources of multiple channels to use multichannel sensors. Set this property to for the master channel and to for the slave channels.
	ACExcitationWireMode	Specifies the number of leads on the LVDT or RVDT. Some sensors require you to tie leads together to create a four- or five- wire sensor. Refer to the sensor documentation for more information.
	AdcCustomTimingMode	Specifies the timing mode of the ADC when AdcTimingMode is Custom.
	AdcTimingMode	Specifies the ADC timing mode, controlling the tradeoff between speed and effective resolution. Some ADC timing modes provide increased powerline noise rejection. On devices that have an AI Convert clock, this setting affects both the maximum and default values for AIConvertRate. You must use the same ADC timing mode for all channels on a device, but you can use different ADC timing modes for different devices in the same task.
	Attenuation	Specifies the amount of attenuation to use.
	AutoZeroMode	Specifies how often to measure ground. NI-DAQmx subtracts the measured ground voltage from every sample.
	AveragingWindowSize	Specifies the number of samples to average while acquiring data. Increasing the number of samples to average reduces noise in your measurement.
	BridgeBalanceCoarsePot	Specifies by how much to compensate for offset in the signal. This value can be between 0 and 127.
	BridgeBalanceFinePot	Specifies by how much to compensate for offset in the signal. This value can be between 0 and 4095.
	BridgeConfiguration	Specifies the type of Wheatstone bridge connected to the channel.
	BridgeElectricalUnits	Specifies from which electrical unit to scale data. Select the same unit that the sensor data sheet or calibration certificate uses for electrical values.
	BridgeInitialRatio	Specifies in volts per volt the ratio of output voltage from the bridge to excitation voltage supplied to the bridge while not under load. NI-DAQmx subtracts this value from any measurements before applying scaling equations. If you set BridgeInitialVoltage, NI-DAQmx coerces this property to BridgeInitialVoltage divided by ExcitationActualValue. If you set this property, NI-DAQmx coerces BridgeInitialVoltage to the value of this property times ExcitationActualValue. If you set both this property and BridgeInitialVoltage, and their values conflict, NI-DAQmx returns an error. To avoid this error, reset one property to its default value before setting the other.
	BridgeInitialVoltage	Specifies in volts the output voltage of the bridge while not under load. NI-DAQmx subtracts this value from any measurements before applying scaling equations. If you set BridgeInitialRatio, NI-DAQmx coerces this property to BridgeInitialRatio times ExcitationActualValue. This property is set by DAQmx Perform Bridge Offset Nulling Calibration. If you set this property, NI-DAQmx coerces BridgeInitialRatio to the value of this property divided by ExcitationActualValue. If you set both this property and BridgeInitialRatio, and their values conflict, NI-DAQmx returns an error. To avoid this error, reset one property to its default value before setting the other.
	BridgeNominalResistance	Specifies in ohms the resistance of the bridge while not under load.
	BridgePhysicalUnits	Specifies to which physical unit to scale electrical data. Select the same unit that the sensor data sheet or calibration certificate uses for physical values.
	BridgePolynomialForwardCoefficients	Specifies an array of coefficients for the polynomial that converts electrical values to physical values. Each element of the array corresponds to a term of the equation. For example, if index three of the array is 9, the fourth term of the equation is 9x^3.
	BridgePolynomialReverseCoefficients	Specifies an array of coefficients for the polynomial that converts physical values to electrical values. Each element of the array corresponds to a term of the equation. For example, if index three of the array is 9, the fourth term of the equation is 9x^3.
	BridgeScaleType	Specifies the scaling type to use when scaling electrical values from the sensor to physical units.
	BridgeShuntCalibrationAActualResistance	Specifies in ohms the actual value of the internal shunt calibration A resistor.
	BridgeShuntCalibrationAResistance	Specifies in ohms the desired value of the internal shunt calibration A resistor.
	BridgeShuntCalibrationASource	Specifies whether to use internal or external shunt when Shunt Cal A is selected.
	BridgeShuntCalibrationBActualResistance	Specifies in ohms the actual value of the internal shunt calibration B resistor.
	BridgeShuntCalibrationBResistance	Specifies in ohms the desired value of the internal shunt calibration B resistor.
	BridgeShuntCalibrationEnable	Specifies whether to enable a shunt calibration switch. Use BridgeShuntCalibrationSelect to select the switch(es) to enable.
	BridgeShuntCalibrationGainAdjust	Specifies the result of a shunt calibration. This property is set by DAQmx Perform Shunt Calibration. NI-DAQmx multiplies data read from the channel by the value of this property. This value should be close to 1.0.
	BridgeShuntCalibrationSelect	Specifies which shunt calibration switch(es) to enable. Use BridgeShuntCalibrationEnable to enable the switch(es) you specify with this property.
	BridgeTableElectricalValues	Specifies the array of electrical values that map to the values in BridgeTablePhysicalValues. Specify this value in the unit indicated by BridgeElectricalUnits.
	BridgeTablePhysicalValues	Specifies the array of physical values that map to the values in BridgeTableElectricalValues. Specify this value in the unit indicated by BridgePhysicalUnits.
	BridgeTwoPointLinearFirstElectricalValue	Specifies the first electrical value, corresponding to BridgeTwoPointLinearFirstPhysicalValue. Specify this value in the unit indicated by BridgeElectricalUnits.
	BridgeTwoPointLinearFirstPhysicalValue	Specifies the first physical value, corresponding to BridgeTwoPointLinearFirstElectricalValue. Specify this value in the unit indicated by BridgePhysicalUnits.
	BridgeTwoPointLinearSecondElectricalValue	Specifies the second electrical value, corresponding to BridgeTwoPointLinearSecondPhysicalValue. Specify this value in the unit indicated by BridgeElectricalUnits.
	BridgeTwoPointLinearSecondPhysicalValue	Specifies the second physical value, corresponding to BridgeTwoPointLinearSecondElectricalValue. Specify this value in the unit indicated by BridgePhysicalUnits.
	BridgeUnits	Specifies in which unit to return voltage ratios from the channel.
	CalibrationApplyIfExpired	Specifies whether to apply the channel calibration to the channel after the expiration date has passed.
	CalibrationDate	Gets or sets the last date and time that the channel underwent a channel calibration.
	CalibrationDescription	Specifies the description entered for the calibration of the channel.
	CalibrationEnable	Specifies whether to enable the channel calibration associated with the channel.
	CalibrationExpirationDate	Gets or sets the date and time that the channel calibration expires.
	CalibrationHasValidInfo	Indicates if the channel has calibration information.
	CalibrationOperatorName	Specifies the name of the operator who performed the channel calibration.
	CalibrationPolynomialForwardCoefficients	Specifies the forward polynomial values used for calibrating the channel.
	CalibrationPolynomialReverseCoefficients	Specifies the reverse polynomial values used for calibrating the channel.
	CalibrationScaleType	Specifies the method or equation form that the calibration scale uses.
	CalibrationTablePreScaledValues	Specifies the reference values collected when calibrating the channel.
	CalibrationTableScaledValues	Specifies the acquired values collected when calibrating the channel.
	CalibrationVerificationAcquiredValues	Specifies the acquired values collected when verifying the calibration. NI-DAQmx stores these values as a record of calibration accuracy and does not use them in the scaling process.
	CalibrationVerificationReferenceValues	Specifies the reference values collected when verifying the calibration. NI-DAQmx stores these values as a record of calibration accuracy and does not use them in the scaling process.
	ChargeUnits	Specifies the units to use to return charge measurements from the channel.
	ChopEnable	Specifies whether the device will chop its inputs. Chopping removes offset voltages and other low frequency errors.
	Coupling	Specifies the coupling for the channel.
	CurrentAcrmsUnits	Specifies the units to use to return current RMS measurements from the channel.
	CurrentShuntLocation	Specifies the shunt resistor location for current measurements.
	CurrentShuntResistance	Specifies in ohms the external shunt resistance for current measurements.
	CurrentUnits	Specifies the units to use to return current measurements from the channel.
	CustomScaleName	Specifies the name of a custom scale for the channel.
	DataTransferCustomThreshold	Specifies the number of samples that must be in the FIFO to transfer data from the device if DataTransferRequestCondition is OnBoardMemoryCustomThreshold.
	DataTransferMaximumRate	Specifies the rate in B/s to transfer data from the device. If this value is not set, then the device will transfer data at a rate based on the bus detected. Modify this value to affect performance under different combinations of operating system, configuration, and device.
	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.
	DCOffset	Specifies the DC value to add to the input range of the device. Use RangeHigh and RangeLow to specify the input range. This offset is in the native units of the device .
	Description	Specifies a user-defined description for the channel. (Inherited from Channel.)
	DeviceScalingCoefficients	Indicates the coefficients of a polynomial equation that NI-DAQmx uses to scale values from the native format of the device to volts. Each element of the array corresponds to a term of the equation. For example, if index two of the array is 4, the third term of the equation is 4x^2. Scaling coefficients do not account for any custom scales or sensors contained by the channel.
	DigitalFilterBandpassCenterFrequency	Specifies the center frequency of the passband for the digital filter.
	DigitalFilterBandpassWidth	Specifies the width of the passband centered around the center frequency for the digital filter.
	DigitalFilterCoefficients	Specifies the digital filter coefficients.
	DigitalFilterEnabled	Specifies whether the digital filter is enabled or disabled.
	DigitalFilterHighpassCutoffFrequency	Specifies the highpass cutoff frequency of the digital filter.
	DigitalFilterLowpassCutoffFrequency	Specifies the lowpass cutoff frequency of the digital filter.
	DigitalFilterNotchCenterFrequency	Specifies the center frequency of the stopband for the digital filter.
	DigitalFilterNotchWidth	Specifies the width of the stopband centered around the center frequency for the digital filter.
	DigitalFilterOrder	Specifies the order of the digital filter.
	DigitalFilterResponse	Specifies the digital filter response.
	DigitalFilterType	Specifies the digital filter type.
	DitherEnable	Specifies whether to enable dithering. Dithering adds Gaussian noise to the input signal. You can use dithering to achieve higher resolution measurements by over sampling the input signal and averaging the results.
	EddyCurrentProximityProbeSensitivity	Specifies the sensitivity of the eddy current proximity probe . This value is in the units you specify with EddyCurrentProximityProbeSensitivityUnits. Refer to the sensor documentation to determine this value.
	EddyCurrentProximityProbeSensitivityUnits	Specifies the units of EddyCurrentProximityProbeSensitivity.
	EddyCurrentProximityProbeUnits	Specifies the units to use to return proximity measurements from the channel.
	EnhancedAliasRejectionEnable	Specifies whether to enable enhanced alias rejection. Leave this property set to the default value for most applications.
	ExcitationActualValue	Specifies the actual amount of excitation supplied by an internal excitation source. If you read an internal excitation source more precisely with an external device, set this property to the value you read. NI-DAQmx ignores this value for external excitation. When performing shunt calibration, some devices set this property automatically.
	ExcitationDCOrAC	Specifies if the excitation supply is DC or AC.
	ExcitationIdleOutputBehavior	Specifies whether this channel will disable excitation after the task is uncommitted. Setting this to Zero Volts or Amps disables excitation after task uncommit. Setting this attribute to Maintain Existing Value leaves the excitation on after task uncommit.
	ExcitationSense	Specifies whether to use local or remote sense to sense excitation.
	ExcitationSource	Specifies the source of excitation.
	ExcitationValue	Specifies the amount of excitation that the sensor requires. If ExcitationVoltageOrCurrent is Voltage, this value is in volts. If ExcitationVoltageOrCurrent is Current, this value is in amperes.
	ExcitationVoltageOrCurrent	Specifies if the channel uses current or voltage excitation.
	FilterDelay	Indicates the amount of time between when the ADC samples data and when the sample is read by the host device. This value is in the units you specify with FilterDelayUnits. You can adjust this amount of time using FilterDelayAdjustment.
	FilterDelayAdjustment	Specifies the amount of filter delay that gets removed if RemoveFilterDelay is enabled. This delay adjustment is in addition to the value indicated by FilterDelay. This delay adjustment is in the units you specify with FilterDelayUnits.
	FilterDelayUnits	Specifies the units of FilterDelay and FilterDelayAdjustment.
	FilterEnabled	Specifies the corresponding filter enable/disable state.
	FilterFrequency	Specifies the corresponding filter frequency (cutoff or center) of the filter response.
	FilterOrder	Specifies the corresponding filter order and defines the slope of the filter response.
	FilterResponse	Specifies the corresponding filter response and defines the shape of the filter response.
	ForceIepeSensorSensitivity	Specifies the sensitivity of the IEPE force sensor connected to the channel. Specify this value in the unit indicated by ForceIepeSensorSensitivityUnits.
	ForceIepeSensorSensitivityUnits	Specifies the units for ForceIepeSensorSensitivity.
	ForceReadFromChannel	Specifies whether to read from the channel if it is a cold-junction compensation channel. By default, reading from the task does not return data from cold-junction compensation channels. Setting this property to forces read operations to return the cold-junction compensation channel data with the other channels in the task.
	ForceReadFromStrainChannel	Specifies whether the data is returned by reading from the task when set on a raw strain channel that is part of a rosette configuration.
	ForceUnits	Specifies in which unit to return force or load measurements from the channel.
	FrequencyHysteresis	Specifies in volts a window below FrequencyThresholdVoltage. The input voltage must pass below FrequencyThresholdVoltage minus this value before NI-DAQmx recognizes a waveform repetition at FrequencyThresholdVoltage. Hysteresis can improve the measurement accuracy when the signal contains noise or jitter.
	FrequencyThresholdVoltage	Specifies the voltage level at which to recognize waveform repetitions. You should select a voltage level that occurs only once within the entire period of a waveform. You also can select a voltage that occurs only once while the voltage rises or falls.
	FrequencyUnits	Specifies the units to use to return frequency measurements from the channel.
	Gain	Specifies a gain factor to apply to the channel.
	Impedance	Specifies the input impedance of the channel.
	InputLimitsFaultDetectEnable	Specifies whether to enable input limits fault detection.
	InputLimitsFaultDetectLowerLimit	Specifies the level of the lower limit for input limits detection. An input sample outside the upper and lower bounds causes a fault. Note: Fault detection applies to both positive and negative inputs. For instance, if you specify a lower limit of 2 mA and an upper limit of 12 mA, NI-DAQmx detects a fault at 15 mA and -15 mA, but not at -6 mA because it is in the range of -12 mA to -2 mA.
	InputLimitsFaultDetectUpperLimit	Specifies the level of the upper limit for input limits detection. An input sample outside the upper and lower bounds causes a fault. Note: Fault detection applies to both positive and negative inputs. For instance, if you specify a lower limit of 2 mA and an upper limit of 12 mA, NI-DAQmx detects a fault at 15 mA and -15 mA, but not at -6 mA because it is in the range of -12 mA to -2 mA.
	InputSource	Specifies the source of the channel. You can use the signal from the I/O connector or one of several calibration signals. Certain devices have a single calibration signal bus. For these devices, you must specify the same calibration signal for all channels you connect to a calibration signal.
	IsGlobal	Indicates whether the channel is a global channel. (Inherited from Channel.)
	IsTeds	Indicates if the virtual channel was initialized using a TEDS bitstream from the corresponding physical channel.
	LeadWireResistance	Specifies in ohms the resistance of the wires that lead to the sensor.
	LossyLsbRemovalCompressedSampleSize	Specifies the number of bits to return in a raw sample when RawDataCompressionType is set to LossyLsbRemoval.
	LowpassCutoffFrequency	Specifies the frequency in Hertz that corresponds to the -3dB cutoff of the filter.
	LowpassEnable	Specifies whether to enable the lowpass filter of the channel.
	LowpassSwitchedCapacitorClockSource	Specifies the source of the filter clock. If you need a higher resolution for the filter, you can supply an external clock to increase the resolution. Refer to the SCXI-1141/1142/1143 User Manual for more information.
	LowpassSwitchedCapacitorExternalClockDivisor	Specifies the divisor for the external clock when you set LowpassSwitchedCapacitorClockSource to External. On the SCXI-1141, SCXI-1142, and SCXI-1143, NI-DAQmx determines the filter cutoff by using the equation f/(100*n), where f is the external frequency, and n is the external clock divisor. Refer to the SCXI-1141/1142/1143 User Manual for more information.
	LowpassSwitchedCapacitorExternalClockFrequency	Specifies the frequency of the external clock when you set LowpassSwitchedCapacitorClockSource to External. NI-DAQmx uses this frequency to set the pre- and post- filters on the SCXI-1141, SCXI-1142, and SCXI-1143. On those devices, NI-DAQmx determines the filter cutoff by using the equation f/(100*n), where f is the external frequency, and n is the external clock divisor. Refer to the SCXI-1141/1142/1143 User Manual for more information.
	LowpassSwitchedCapacitorOutputClockDivisor	Specifies the divisor for the output clock. NI-DAQmx uses the cutoff frequency to determine the output clock frequency. Refer to the SCXI-1141/1142/1143 User Manual for more information.
	LvdtSensitivity	Specifies the sensitivity of the LVDT. This value is in the units you specify with LvdtSensitivityUnits. Refer to the sensor documentation to determine this value.
	LvdtSensitivityUnits	Specifies the units of LvdtSensitivity.
	LvdtUnits	Specifies the units to use to return linear position measurements from the channel.
	Maximum	Specifies the maximum value you expect to measure. This value is in the units you specify with a units property. When you query this property, it returns the coerced maximum value that the device can measure with the current settings.
	MaximumSoundPressureLevel	Specifies the maximum instantaneous sound pressure level you expect to measure. This value is in decibels, referenced to 20 micropascals. NI-DAQmx uses the maximum sound pressure level to calculate values in pascals for Maximum and Minimum for the channel.
	MeasurementType	Indicates the measurement to take with the analog input channel and in some cases, such as for temperature measurements, the sensor to use.
	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.
	MicrophoneSensitivity	Specifies the sensitivity of the microphone. This value is in mV/Pa. Refer to the sensor documentation to determine this value.
	Minimum	Specifies the minimum value you expect to measure. This value is in the units you specify with a units property. When you query this property, it returns the coerced minimum value that the device can measure with the current settings.
	OpenChannelDetectEnable	Specifies whether to enable open channel detection.
	OpenThermocoupleDetectEnable	Specifies whether to apply the open thermocouple detection bias voltage to the channel. Changing the value of this property on a channel may require settling time before the data returned is valid. To compensate for this settling time, discard unsettled data or add a delay between committing and starting the task. Refer to your device specifications for the required settling time. When open thermocouple detection is enabled, use OpenThermocoupleChannelsExist to determine if any channels were open.
	OvercurrentDetectEnable	Specifies whether to enable overcurrent detection.
	PhysicalName	Specifies the name of the physical channel upon which this virtual channel is based. (Inherited from Channel.)
	PowerSupplyFaultDetectEnable	Specifies whether to enable power supply fault detection.
	PressureUnits	Specifies in which unit to return pressure measurements from the channel.
	ProbeAttenuation	Specifies the amount of attenuation provided by the probe connected to the channel. Specify this attenuation as a ratio.
	RangeHigh	Specifies the upper limit of the input range of the device. This value is in the native units of the device. On E Series devices, for example, the native units is volts.
	RangeLow	Specifies the lower limit of the input range of the device. This value is in the native units of the device. On E Series devices, for example, the native units is volts.
	RawDataCompressionType	Specifies the type of compression to apply to raw samples returned from the device.
	RawSampleJustification	Indicates the justification of a raw sample from the device.
	RawSampleSize	Indicates in bits the size of a raw sample from the device.
	ReadOpenChannels	Indicates a list of names of any open virtual channels. You must read ReadOpenChannelsExist before you read this property. Otherwise you will receive an error.
	ReadOpenChannelsDetails	Indicates a list of details of any open virtual channels. You must read ReadOpenChannelsExist before you read this property. Otherwise you will receive an error.
	ReadOpenChannelsExist	Indicates if the device or devices detected an open channel condition in any virtual channel in the task. Reading this property clears the open channel status for all channels in this task. You must read this property before you read ReadOpenChannels. Otherwise, you will receive an error.
	RemoveFilterDelay	Specifies if filter delay removal is enabled on the device.
	ResistanceConfiguration	Specifies the resistance configuration for the channel. NI-DAQmx uses this value for any resistance-based measurements, including temperature measurement using a thermistor or RTD.
	ResistanceUnits	Specifies the units to use to return resistance measurements.
	Resolution	Indicates the resolution of the analog-to-digital converter of the channel. This value is in the units you specify with ResolutionUnits.
	ResolutionUnits	Indicates the units of Resolution.
	RosetteMeasurementType	Specifies the type of rosette measurement.
	RosetteStrainChannels	Indicates the raw strain channels that comprise the strain rosette.
	RosetteStrainGageOrientation	Specifies gage orientation in degrees with respect to the X axis.
	RosetteType	Indicates the type of rosette gage.
	RtdA	Specifies the 'A' constant of the Callendar-Van Dusen equation. NI-DAQmx requires this value when you use a custom RTD.
	RtdB	Specifies the 'B' constant of the Callendar-Van Dusen equation. NI-DAQmx requires this value when you use a custom RTD.
	RtdC	Specifies the 'C' constant of the Callendar-Van Dusen equation. NI-DAQmx requires this value when you use a custom RTD.
	RtdR0	Specifies in ohms the sensor resistance at 0 deg C. The Callendar-Van Dusen equation requires this value. Refer to the sensor documentation to determine this value.
	RtdType	Specifies the type of RTD connected to the channel.
	RvdtSensitivity	Specifies the sensitivity of the RVDT. This value is in the units you specify with RvdtSensitivityUnits. Refer to the sensor documentation to determine this value.
	RvdtSensitivityUnits	Specifies the units of RvdtSensitivity.
	RvdtUnits	Specifies the units to use to return angular position measurements from the channel.
	SampleAndHoldEnable	Specifies whether to enable the sample and hold circuitry of the device. When you disable sample and hold circuitry, a small voltage offset might be introduced into the signal. You can eliminate this offset by using AutoZeroMode to perform an auto zero on the channel.
	SensorPowerConfiguration	Specifies whether to turn on the sensor's power supply or to leave the configuration unchanged.
	SensorPowerType	Specifies the type of power supplied to the sensor.
	SensorPowerVoltage	Specifies the voltage level for the sensor's power supply.
	SoundPressureDecibelReference	Specifies the decibel reference level in the units of the channel. When you read samples as a waveform, the decibel reference level is included in the waveform attributes. NI-DAQmx also uses the decibel reference level when converting MaximumSoundPressureLevel to a voltage level.
	SoundPressureUnits	Specifies the units to use to return sound pressure measurements from the channel.
	StrainGageConfiguration	Specifies the bridge configuration of the strain gages.
	StrainGageGageFactor	Specifies the sensitivity of the strain gage. Gage factor relates the change in electrical resistance to the change in strain. Refer to the sensor documentation for this value.
	StrainGagePoissonRatio	Specifies the ratio of lateral strain to axial strain in the material you are measuring.
	StrainUnits	Specifies the units to use to return strain measurements from the channel.
	SynchronizationUnlockBehavior	Specifies the action to take if the target loses its synchronization to the grand master. (Inherited from Channel.)
	TedsUnits	Indicates the units defined by TEDS information associated with the channel.
	TemperatureUnits	Specifies the units to use to return temperature measurements from the channel.
	TerminalConfiguration	Specifies the terminal configuration for the channel.
	ThermistorA	Specifies the 'A' constant of the Steinhart-Hart thermistor equation.
	ThermistorB	Specifies the 'B' constant of the Steinhart-Hart thermistor equation.
	ThermistorC	Specifies the 'C' constant of the Steinhart-Hart thermistor equation.
	ThermistorR1	Specifies in ohms the value of the reference resistor for the thermistor if you use voltage excitation. NI-DAQmx ignores this value for current excitation.
	ThermocoupleCjcChannel	Indicates the channel that acquires the temperature of the cold junction if ThermocoupleCjcSource is Channel. If the channel is a temperature channel, NI-DAQmx acquires the temperature in the correct units. Other channel types, such as a resistance channel with a custom sensor, must use a custom scale to scale values to degrees Celsius.
	ThermocoupleCjcSource	Indicates the source of cold-junction compensation.
	ThermocoupleCjcValue	Specifies the temperature of the cold junction if ThermocoupleCjcSource is ConstantValue. Specify this value in the units of the measurement.
	ThermocoupleLeadOffsetVoltage	Specifies the lead offset nulling voltage to subtract from measurements on a device. This property is ignored if open thermocouple detection is disabled.
	ThermocoupleScaleType	Specifies the method or equation form that the thermocouple scale uses.
	ThermocoupleType	Specifies the type of thermocouple connected to the channel. Thermocouple types differ in composition and measurement range.
	TorqueUnits	Specifies in which unit to return torque measurements from the channel.
	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.
	UseExcitationForScaling	Specifies if NI-DAQmx divides the measurement by the excitation. You should typically set this property to for ratiometric transducers. If you set this property to , set Maximum and Minimum to reflect the scaling.
	UseMultiplexedExcitation	Specifies if the SCXI-1122 multiplexes the excitation to the upper half of the channels as it advances through the scan list.
	VelocityIepeSensorDecibelReference	Specifies the decibel reference level in the units of the channel. When you read samples as a waveform, the decibel reference level is included in the waveform attributes.
	VelocityIepeSensorSensitivity	Specifies the sensitivity of the IEPE velocity sensor connected to the channel. Specify this value in the unit indicated by VelocityIepeSensorSensitivityUnits.
	VelocityIepeSensorSensitivityUnits	Specifies the units for VelocityIepeSensorSensitivity.
	VelocityUnits	Specifies in which unit to return velocity measurements from the channel.
	VirtualName	Gets the name of the virtual channel. (Inherited from Channel.)
	VoltageAcrmsUnits	Specifies the units to use to return voltage RMS measurements from the channel.
	VoltageDecibelReference	Specifies the decibel reference level in the units of the channel. When you read samples as a waveform, the decibel reference level is included in the waveform attributes.
	VoltageUnits	Specifies the units to use to return voltage measurements from the channel.

Top

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.)
	PerformBridgeOffsetNullingCalibration	Performs a bridge offset nulling calibration on the virtual channels in the task. An error will occur if not all virtual channels in the task support this operation.
	PerformBridgeOffsetNullingCalibration(Boolean)	Performs a bridge offset nulling calibration on the virtual channels in the task.
	PerformBridgeShuntCalibration(Double, ShuntElementLocation, Double)	Performs shunt calibration for the virtual channels in the task using a bridge sensor. An error will occur if not all virtual channels in the task support this operation.
	PerformBridgeShuntCalibration(Double, ShuntElementLocation, Double, Boolean)	Performs shunt calibration for the virtual channels in the task using a bridge sensor.
	PerformBridgeShuntCalibration(Double, ShuntElementLocation, Double, ShuntCalibrationSelect, ShuntResistorSource)	Performs shunt calibration for the specified channels using a bridge sensor.
	PerformBridgeShuntCalibration(Double, ShuntElementLocation, Double, ShuntCalibrationSelect, ShuntResistorSource, Boolean)	Performs shunt calibration for the specified channels using a bridge sensor.
	PerformStrainShuntCalibration(Double, ShuntElementLocation)	Performs shunt calibration for the virtual channels in the task using a strain gage sensor. An error will occur if not all virtual channels in the task support this operation.
	PerformStrainShuntCalibration(Double, ShuntElementLocation, Boolean)	Performs shunt calibration for the virtual channels in the task using a strain gage sensor.
	PerformStrainShuntCalibration(Double, ShuntElementLocation, ShuntCalibrationSelect, ShuntResistorSource)	Performs shunt calibration for the specified channels using a strain gage sensor.
	PerformStrainShuntCalibration(Double, ShuntElementLocation, ShuntCalibrationSelect, ShuntResistorSource, Boolean)	Performs shunt calibration for the specified channels using a strain gage sensor.
	PerformThermocoupleLeadOffsetNullingCalibration	Performs thermocouple lead offset nulling calibration on the channels in the task to compensate for offsets introduced by open thermocouple detection. An error will occur if not all virtual channels in the task support this operation.
	PerformThermocoupleLeadOffsetNullingCalibration(Boolean)	Performs thermocouple lead offset nulling calibration on the channels in the task to compensate for offsets introduced by open thermocouple detection. Use this method to specify whether or not to skip channels that do not support calibration.
	ToString	Returns a string representation of the object. (Inherited from Channel.)

Top

Remarks

Use the AIChannels property to create or access an analog input virtual channel. An AIChannel might contain more than one virtual channel because the AIChannel is defined by providing a valid NI-DAQmx channel string to the AIChannels indexer or to an AIChannelCollection create virtual channel method. If you set a property on an AIChannel object that represents multiple virtual channels, that property is set for all of the virtual 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.

NI-DAQmx .NET Framework 4.0 API Reference

Filters

Content Type

Programming Language

Table of Contents

AIChannel Class

AIChannel Class

Inheritance Hierarchy

Syntax

Properties

Methods

Remarks

Thread Safety

See Also

Reference

In This Section

Additional Comments

Download PDF