Contains properties and methods that configure how the task begins measurement or generation.

Derives from

Syntax

Namespace: NationalInstruments.DAQmx

public class StartTrigger : MarshalByRefObject, IFilteredTypeDescriptor

Remarks

Note

Example applications are located in the <Public Documents>\National Instruments\NI-DAQ\Examples\DotNET4.x directory or in the Start menu at National Instruments»NI-DAQmx»NI-DAQmx Examples.

Thread Safety

All members of this type are safe for multithreaded operations.

Properties

NameDescription
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 true, 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

NameDescription
ConfigureAnalogEdgeTrigger(string, AnalogEdgeStartTriggerSlope, double)

Configures the task to start acquiring or generating samples when an analog signal crosses the level you specify.

ConfigureAnalogMultiEdgeTrigger(string, AnalogMultiEdgeStartTriggerSlope[], double[])

Configures the task to start acquiring or generating samples when any of the configured analog signals cross the respective levels you specify.

ConfigureAnalogWindowTrigger(string, AnalogWindowStartTriggerCondition, double, double)

Configures the task to start acquiring or generating samples when an analog signal enters or leaves a range you specify.

ConfigureDigitalEdgeTrigger(string, DigitalEdgeStartTriggerEdge)

Configures the task to start acquiring or generating samples on a rising or falling edge of a digital signal.

ConfigureDigitalPatternTrigger(string, string, DigitalPatternStartTriggerCondition)

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(PrecisionDateTime, TimeStartTriggerTimescale)

Configures the task to start acquiring or generating samples at a the specified triggerTime .

ToString()

Returns a string representation of the object.

See Also