StartTrigger Class
- Updated2023-02-21
- 6 minute(s) read
StartTrigger Class
Contains properties and methods that configure how the task begins measurement or generation.
Inheritance Hierarchy
SystemObject
SystemMarshalByRefObject
NationalInstruments.DAQmxStartTrigger
SystemMarshalByRefObject
NationalInstruments.DAQmxStartTrigger
Namespace: NationalInstruments.DAQmx
Assembly: NationalInstruments.DAQmx (in NationalInstruments.DAQmx.dll) Version: 20.7.40.49302
Syntax
public class StartTrigger : MarshalByRefObject, IFilteredTypeDescriptor
Public Class StartTrigger Inherits MarshalByRefObject Implements IFilteredTypeDescriptor
The StartTrigger type exposes the following members.
Properties
| Name | Description | |
|---|---|---|
 | AnalogEdge | Gets the AnalogEdgeStartTrigger. |
| AnalogMultiEdge | Gets the AnalogMultiEdgeStartTrigger. |
| AnalogWindow | Gets the AnalogWindowStartTrigger. |
| Delay | Specifies an amount of time to wait after the Start Trigger is received before acquiring or generating the first sample. This value is in the units you specify with DelayUnits. |
| DelayUnits | Specifies the units of Delay. |
| DigitalEdge | Gets the DigitalEdgeStartTrigger. |
| DigitalPattern | Gets the DigitalPatternStartTrigger. |
| MaximumNumberOfTriggersToDetect | Specifies the maximum number of times the task will detect a start trigger during the task. The number of times a trigger is detected and acted upon by the module may be less than the specified amount if the task stops early because of trigger/retrigger window expiration. Specifying the Maximum Number of Triggers to Detect to be 0 causes the driver to automatically set this value to the maximum possible number of triggers detectable by the device and configuration combination. Note: The number of detected triggers may be less than number of trigger events occurring, because the devices were unable to respond to the trigger. |
| Retriggerable | Specifies whether a finite task resets and waits for another Start Trigger after the task completes. When you set this property to , the device performs a finite acquisition or generation each time the Start Trigger occurs until the task stops. The device ignores a trigger if it is in the process of acquiring or generating signals. |
| RetriggerWindow | Specifies the period of time in seconds after each trigger during which the device may trigger. Once the window has expired, the device stops detecting triggers, and the task will finish after the device finishes acquiring post-trigger samples that it already started. Ensure the period of time specified covers the entire time span desired for retrigger detection to avoid missed triggers. Specifying a Retrigger Window of -1 causes the window to be infinite. |
| Terminal | Indicates the name of the internal Start Trigger terminal for the task. This property does not return the name of the trigger source terminal. |
| Time | Gets the TimeStartTrigger. |
| Timestamp | Gets the start trigger timestamp. |
| TimestampEnable | Specifies whether the start trigger timestamp is enabled. If the timestamp is enabled but no resources are available, an error will be returned at run time. |
| TimestampTimescale | Specifies the start trigger timestamp timescale. |
| TriggerWindow | Specifies the period of time in seconds after the task starts during which the device may trigger. Once the window has expired, the device stops detecting triggers, and the task will finish after the device finishes acquiring post-trigger samples for any triggers detected. If no triggers are detected during the entire period, then no data will be returned. Ensure the period of time specified covers the entire time span desired for trigger detection to avoid missed triggers. Specifying a Trigger Window of -1 causes the window to be infinite. |
| Type | Specifies the type of trigger to use to start a task. |
Methods
| Name | Description | |
|---|---|---|
 | ConfigureAnalogEdgeTrigger | Configures the task to start acquiring or generating samples when an analog signal crosses the level you specify.
|
| ConfigureAnalogMultiEdgeTrigger | Configures the task to start acquiring or generating samples when any of the configured analog signals cross the respective levels you specify. |
| ConfigureAnalogWindowTrigger |
Configures the task to start acquiring or generating samples when an analog signal enters or leaves a range you specify.
|
| ConfigureDigitalEdgeTrigger | Configures the task to start acquiring or generating samples on a rising or falling edge of a digital signal.
|
| ConfigureDigitalPatternTrigger | Configures the task to start acquiring or generating samples when a digital pattern is matched. |
| ConfigureNone |
Configures the task to start acquiring or generating samples immediately upon starting the task.
|
| ConfigureTimeTrigger | Configures the task to start acquiring or generating samples at a the specified triggerTime. |
| CreateObjRef | Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.) |
| Equals | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
 | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
| GetLifetimeService | Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| InitializeLifetimeService | Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| MemberwiseClone(Boolean) | Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.) |
| ToString | Returns a string representation of the object. (Overrides ObjectToString.) |
Remarks
 Tip |
|---|
| Example applications are located in the Public Documents\National Instruments\NI-DAQ\Examples\DotNET4.x directory or in the Start menu at National InstrumentsNI-DAQmxNI-DAQmx Examples. |
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.