DAQmxCfgAnlgWindowRefTrig

NI-DAQmx C Functions

DAQmxCfgAnlgWindowRefTrig

int32 DAQmxCfgAnlgWindowRefTrig (TaskHandle taskHandle, const char triggerSource[], int32 triggerWhen, float64 windowTop, float64 windowBottom, uInt32 pretriggerSamples);

Purpose

Configures the task to stop the acquisition when the device acquires all pretrigger samples, an analog signal enters or leaves a range you specify, and the device acquires all post-trigger samples.

Parameters

Input
Name Type Description
taskHandle TaskHandle The task used in this function.
triggerSource const char [] 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.
triggerWhen int32 Specifies whether the Reference Trigger occurs when the signal enters the window or when it leaves the window. Use windowBottom and windowTop to specify the limits of the window.
Value Description
DAQmx_Val_EnteringWin Trigger when the signal enters the window.
DAQmx_Val_LeavingWin Trigger when the signal leaves the window.
windowTop float64 The upper limit of the window. Specify this value in the units of the measurement or generation.
windowBottom float64 The lower limit of the window. Specify this value in the units of the measurement or generation.
pretriggerSamples uInt32 The minimum number of samples per channel to acquire before recognizing the Reference Trigger. The number of posttrigger samples per channel is equal to number of samples per channel in the NI-DAQmx Timing functions minus pretriggerSamples.

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.