DAQmxCreateAOFuncGenChan

NI-DAQmx C Functions

DAQmxCreateAOFuncGenChan

int32 DAQmxCreateAOFuncGenChan (TaskHandle taskHandle, const char physicalChannel[], const char nameToAssignToChannel[], int32 type, float64 frequency, float64 amplitude, float64 offset);

Purpose

Creates a channel for continually generating a waveform on the selected physical channel.

Parameters

Input
Name Type Description
taskHandle TaskHandle The task to which to add the channels that this function creates.
physicalChannel const char [] The names of the physical channels to use to create virtual channels. You can specify a list or range of physical channels.
nameToAssignToChannel const char [] 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 functions.
If you create multiple virtual channels with one call to this function, you can specify a list of names separated by commas. If you provide fewer names than the number of virtual channels you create, NI-DAQmx automatically assigns names to the virtual channels.
type int32 Specifies the kind of waveform to generate.
Value Description
DAQmx_Val_Sine Sine wave
DAQmx_Val_Triangle Triangle wave
DAQmx_Val_Square Sawtooth wave
DAQmx_Val_Sawtooth Square wave
frequency float64 The frequency of the waveform to generate in hertz.
amplitude float64 The zero-to-peak amplitude of the waveform to generate in volts. Zero and negative values are valid.
offset float64 The voltage offset of the waveform to generate.

Return Value

Name Type Description
status int32 The error code returned by the function in the event of an error or warning. A value of 0 indicates success. A positive value indicates a warning. A negative value indicates an error.