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. When you use a Reference Trigger, the default for the read RelativeTo property is First Pretrigger Sample with a read Offset of 0.


icon

Inputs/Outputs

  • ci32.png when —

    when specifies whether the Reference Trigger occurs when the signal enters the window or when it leaves the window. Use window bottom and window top to specify the limits of the window.

    Entering Window (10163)

    Trigger when the signal enters the window.

    Leaving Window (10208)

    Trigger when the signal leaves the window.

  • cgenclassrntag.png task/channels in —

    task/channels in is the name of the task or a list of virtual channels to which the operation applies. If you provide a list of virtual channels, NI-DAQmx creates a task automatically.

  • cstr.png source —

    source is 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.

  • cdbl.png window top —

    window top is the upper limit of the window. Specify this value in the units of the measurement or generation.

  • cdbl.png window bottom —

    window bottom is the lower limit of the window. Specify this value in the units of the measurement or generation.

  • cerrcodeclst.png error in —

    error in describes error conditions that occur before this VI or function runs.

    The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. If an error occurs while this VI or function runs, the VI or function runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.

  • cu32.png pretrigger samples per channel —

    pretrigger samples per channel specifies the minimum number of samples to acquire per channel before recognizing the Reference Trigger. The number of post-trigger samples per channel is equal to number of samples per channel in the DAQmx Timing VI minus pretrigger samples per channel.

  • igenclassrntag.png task out —

    task out is a reference to the task after this VI or function runs. If you wired a channel or list of channels to task/channels in, NI-DAQmx creates this task automatically.

  • ierrcodeclst.png error out —

    error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, error out describes the error status that this VI or function produces.

    Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.