COChannelCollection.CreatePulseChannelFrequency Method
- Updated2023-02-21
- 2 minute(s) read
Namespace: NationalInstruments.DAQmx
Assembly: NationalInstruments.DAQmx (in NationalInstruments.DAQmx.dll) Version: 20.7.40.49302
Syntax
public COChannel CreatePulseChannelFrequency( string counter, string nameToAssignChannel, COPulseFrequencyUnits units, COPulseIdleState idleState, double initialDelay, double frequency, double dutyCycle )
Public Function CreatePulseChannelFrequency ( counter As String, nameToAssignChannel As String, units As COPulseFrequencyUnits, idleState As COPulseIdleState, initialDelay As Double, frequency As Double, dutyCycle As Double ) As COChannel
Parameters
- counter
- Type: SystemString
The names of the counters to use to create the virtual channel. - 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. - units
- Type: NationalInstruments.DAQmxCOPulseFrequencyUnits
The units to use to define pulse frequency. - idleState
- Type: NationalInstruments.DAQmxCOPulseIdleState
The resting state of the output terminal. - initialDelay
- Type: SystemDouble
The amount of time in seconds to wait before generating the first pulse. - frequency
- Type: SystemDouble
The frequency at which to generate the pulse. - dutyCycle
- Type: SystemDouble
The width of the pulse divided by pulse period. NI-DAQmx uses this ratio, combined with frequency, to determine both pulse width and the interval between pulses.
Return Value
Type: COChannelThe newly created COChannel.
Exceptions
| Exception | Condition |
|---|---|
| DaqException | The NI-DAQmx driver returned an error. |
Remarks
When you use this method, the pulses appear on the default output terminal of the counter unless you select a different output terminal.
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 counter 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. CreatePulseChannelFrequency(String, String, COPulseFrequencyUnits, COPulseIdleState, Double, Double, Double) 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.