niHSDIO_ConfigureDigitalEdgeRefTrigger

NI Digital Waveform Generator/Analyzer

niHSDIO_ConfigureDigitalEdgeRefTrigger

Specific Function

C Function Prototype

ViStatus niHSDIO_ConfigureDigitalEdgeRefTrigger (ViSession vi, ViConstString source, ViInt32 edge, ViInt32 pretriggerSamples);

Purpose

Configures the Reference trigger for edge triggering in an acquisition. If the Reference trigger asserts before all the pretrigger samples are acquired, then it is ignored. This function is only valid for acquisition operations.

Parameters

Name Type Description
vi ViSession This handle identifies your instrument session. vi was obtained from niHSDIO_InitAcquisitionSession.
source ViConstString You may specify any valid source terminal for this trigger. Trigger voltages and positions are only relevant if the source of the trigger is from the front panel connectors.

Refer to NIHSDIO_ATTR_DIGITAL_EDGE_REF_TRIGGER_SOURCE for possible values.
edge ViInt32 Specifies the edge to detect.

Defined Values

NIHSDIO_VAL_RISING_EDGE (12)—Rising edge trigger.
NIHSDIO_VAL_FALLING_EDGE (13)—Falling edge trigger.

Default Value: NIHSDIO_VAL_RISING_EDGE
pretriggerSamples ViInt32 Specifies the number of necessary pretrigger samples before the Reference trigger is acknowledged.

Return Value