DAQmxCreateCOPulseChanFreq
int32 DAQmxCreateCOPulseChanFreq (TaskHandle taskHandle, const
char counter[], const char nameToAssignToChannel[], int32 units, int32
idleState, float64 initialDelay, float64 freq, float64 dutyCycle);
Purpose
Creates channel(s) to generate digital pulses that
freq and dutyCycle define and adds the channel
to the task you specify with taskHandle. The pulses appear on
the default output
terminal of the counter unless you select a different output terminal.
Parameters
|
Input
|
| Name |
Type |
Description |
|
taskHandle
|
TaskHandle |
The task to which to add the channels that this function creates. |
|
counter
|
const char []
|
The name of the counter 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. |
|
units
|
int32 |
The units in which to specify freq.
| Name |
|
Description |
|
DAQmx_Val_Hz
|
|
hertz |
|
|
idleState
|
int32 |
The resting state of the output terminal.
| Value |
|
Description |
|
DAQmx_Val_High
|
|
High state. |
|
DAQmx_Val_Low
|
|
Low state. |
|
|
initialDelay
|
float64 |
The amount of time in seconds to wait before generating the first pulse. |
|
freq
|
float64 |
The frequency at which to generate pulses. |
|
dutyCycle
|
float64 |
The width of the pulse divided by the pulse period. NI-DAQmx uses this
ratio, combined with frequency, to determine pulse width and the interval
between pulses. |
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. |