NI-DAQmx .NET Framework 4.5 API Reference

ReferenceTrigger.ConfigureAnalogEdgeTrigger Method

  • Updated2023-02-21
  • 2 minute(s) read
ReferenceTrigger.ConfigureAnalogEdgeTrigger Method
Configures the task to stop the acquisition when the device acquires all pretrigger samples; an analog signal reaches the level you specify; and the device acquires all post-trigger samples.

Namespace:  NationalInstruments.DAQmx
Assembly:  NationalInstruments.DAQmx (in NationalInstruments.DAQmx.dll) Version: 20.7.45.49302

Syntax

public void ConfigureAnalogEdgeTrigger(
	string source,
	AnalogEdgeReferenceTriggerSlope slope,
	double level,
	long pretriggerSamples
)
Public Sub ConfigureAnalogEdgeTrigger ( 
	source As String,
	slope As AnalogEdgeReferenceTriggerSlope,
	level As Double,
	pretriggerSamples As Long
)

Parameters

source
Type: SystemString
The name of a virtual channel or terminal where there is an analog signal to use as the source of the trigger. For E Series devices, if you use a virtual channel, it must be the only channel in the task. The only terminal you can use for E Series devices is PFI0.
slope
Type: NationalInstruments.DAQmxAnalogEdgeReferenceTriggerSlope
The slope of the signal on which the reference trigger occurs.
level
Type: SystemDouble
The threshold, in the units of the measurement or generation, to trigger. Use slope to specify on which slope to trigger at this threshold.
pretriggerSamples
Type: SystemInt64
The minimum number of samples per channel to acquire before recognizing the reference trigger.

Exceptions

ExceptionCondition
DaqExceptionThe NI-DAQmx driver returned an error.

Remarks

The number of post-trigger samples is equal to the value of SamplesPerChannel minus the value of pretriggerSamples. If pretriggerSamples equals SamplesPerChannel, the measurement or generation stops when the reference trigger occurs.

When you use a Reference Trigger, the default value of the ReadRelativeTo property is FirstPretriggerSample with a ReadOffset value of 0.

The NI-DAQmx driver does not determine if the requested settings are possible until the task is verified. ConfigureAnalogEdgeTrigger(String, AnalogEdgeReferenceTriggerSlope, Double, Int64) 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.

See Also

Log in to get a better experience