AIChannelCollection.CreateAccelerationFourWireDCVoltageChannel Method (String, String, AITerminalConfiguration, Double, Double, String, Double, AIAccelerationFourWireDCVoltageSensitivityUnits, AIExcitationSource, Double, Boolean)
- Updated2023-02-21
- 3 minute(s) read
Namespace: NationalInstruments.DAQmx
Assembly: NationalInstruments.DAQmx (in NationalInstruments.DAQmx.dll) Version: 20.7.45.49302
Syntax
public AIChannel CreateAccelerationFourWireDCVoltageChannel( string physicalChannelName, string nameToAssignChannel, AITerminalConfiguration terminalConfiguration, double minimumValue, double maximumValue, string customScaleName, double sensitivity, AIAccelerationFourWireDCVoltageSensitivityUnits sensitivityUnits, AIExcitationSource voltageExcitationSource, double voltageExcitationValue, bool useExcitationForScaling )
Public Function CreateAccelerationFourWireDCVoltageChannel ( physicalChannelName As String, nameToAssignChannel As String, terminalConfiguration As AITerminalConfiguration, minimumValue As Double, maximumValue As Double, customScaleName As String, sensitivity As Double, sensitivityUnits As AIAccelerationFourWireDCVoltageSensitivityUnits, voltageExcitationSource As AIExcitationSource, voltageExcitationValue As Double, useExcitationForScaling As Boolean ) As AIChannel
Parameters
- physicalChannelName
- Type: SystemString
The names of the physical channels to use to create virtual channels. You can specify a list or range of physical channels. - nameToAssignChannel
- Type: SystemString
The name(s) to assign to the created virtual channel(s). If you do not specify a name, NI-DAQmx uses the physical channel name as the virtual channel name. If you specify your own names for nameToAssignToChannel, you must use the names when you refer to these channels in other NI-DAQmx methods. - terminalConfiguration
- Type: NationalInstruments.DAQmxAITerminalConfiguration
The input TerminalConfigurationTypes for the channel. - minimumValue
- Type: SystemDouble
The minimum value, in units, that you expect to measure. - maximumValue
- Type: SystemDouble
The maximum value, in units, that you expect to measure. - customScaleName
- Type: SystemString
The name of a custom scale to apply to the channel. To use this parameter, you must set units to FromCustomScale. If you do not set units to FromCustomScale, you must set customScaleName to . - sensitivity
- Type: SystemDouble
The sensitivity of the sensor. This value is in the units you specify with the sensitivityUnits input. Refer to the sensor documentation to determine this value. - sensitivityUnits
- Type: NationalInstruments.DAQmxAIAccelerationFourWireDCVoltageSensitivityUnits
The units of sensitivity. - voltageExcitationSource
- Type: NationalInstruments.DAQmxAIExcitationSource
The source of excitation. TODO - There are values for this specified in the C API. Include them here, or should this reference an enum? - voltageExcitationValue
- Type: SystemDouble
Specifies in volts the amount of excitation supplied to the sensor. Refer to the sensor documentation to determine appropriate excitation values. - useExcitationForScaling
- Type: SystemBoolean
Specifies whether NI-DAQmx divides the measurement by the excitation. You should typically set useExcitationForScaling to for ratiometric transducers. If you set useExcitationForScaling to , set maximumValue and minimumValue to reflect the scaling.
Return Value
Type: AIChannelThe newly created AIChannel.
Exceptions
| Exception | Condition |
|---|---|
| DaqException | The NI-DAQmx driver returned an error. |
Remarks
This method creates a local virtual channel for every physical channel name you specify. If you create multiple local virtual channels with one call to this method, you can specify a comma-delimited list of names for nameToAssignChannel. If you provide fewer local virtual channel names in nameToAssignChannel than you create, NI-DAQmx automatically assigns names to the local virtual channels.
If you do not provide a value for nameToAssignChannel, NI-DAQmx uses the physicalChannelName as the local virtual channel name. If you use nameToAssignChannel to create a name for the local virtual channel, you must use this name in other properties and methods.
The NI-DAQmx driver does not determine if the requested settings are possible until the task is verified. CreateAccelerometerChannel(String, String, AITerminalConfiguration, Double, Double, Double, AIAccelerometerSensitivityUnits, AIExcitationSource, Double, AIAccelerationUnits) 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.