NI-DAQmx .NET Framework 4.5 API Reference

AOChannelCollection.CreateFunctionGenerationChannel Method (String, String, AOFunctionGenerationType, Double, Double, Double)

  • Updated2023-02-21
  • 2 minute(s) read
AOChannelCollection.CreateFunctionGenerationChannel Method (String, String, AOFunctionGenerationType, Double, Double, Double)
Creates an AOChannel that continuously generates a waveform with the specificed waveform type, frequency, amplitude, and offset. This method adds one or more channels to the AOChannelCollection.

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

Syntax

public AOChannel CreateFunctionGenerationChannel(
	string physicalChannelName,
	string nameToAssignChannel,
	AOFunctionGenerationType waveformType,
	double frequency,
	double amplitude,
	double offset
)
Public Function CreateFunctionGenerationChannel ( 
	physicalChannelName As String,
	nameToAssignChannel As String,
	waveformType As AOFunctionGenerationType,
	frequency As Double,
	amplitude As Double,
	offset As Double
) As AOChannel

Parameters

physicalChannelName
Type: SystemString
The names of one or more physical channels to use to create one or more local virtual channels.
nameToAssignChannel
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.
waveformType
Type: NationalInstruments.DAQmxAOFunctionGenerationType
The AOFunctionGenerationType to generate.
frequency
Type: SystemDouble
The desired frequency of the output waveformType.
amplitude
Type: SystemDouble
The desired amplitude of the output waveformType, in units of volts zero-to-peak. Zero and negative values are valid.
offset
Type: SystemDouble
The desired offset of the output waveformType.

Return Value

Type: AOChannel
The newly created AOChannel.

Exceptions

ExceptionCondition
DaqExceptionThe 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. CreateCurrentChannel(String, String, Double, Double, String) 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.

See Also

Log in to get a better experience