niHSDIO_SendSoftwareEdgeTrigger

NI Digital Waveform Generator/Analyzer

niHSDIO_SendSoftwareEdgeTrigger

Specific Function

C Function Prototype

ViStatus niHSDIO_SendSoftwareEdgeTrigger (ViSession vi, ViInt32 trigger, ViConstString triggerIdentifier);

Purpose

Use this function to force a particular edge-based trigger to occur. This function applies to the Start, Reference, Advance, and Script triggers, and is valid if the particular trigger is configured for edge, pattern match, or software triggering (for edge or pattern-match triggers you can use niHSDIO_SendSoftwareEdgeTrigger as a software override).

Parameters

Name Type Description
vi ViSession This handle identifies your instrument session. vi was obtained from the niHSDIO_InitAcquisitionSession or niHSDIO_InitGenerationSession function.
trigger ViInt32 The trigger to assert.

Defined Values

NIHSDIO_VAL_START_TRIGGER (53)—Start trigger for dynamic acquisition or generation.
NIHSDIO_VAL_REF_TRIGGER (54)—Reference trigger for dynamic acquisition.
NIHSDIO_VAL_SCRIPT_TRIGGER (58)—Script trigger for dynamic generation.
NIHSDIO_VAL_ADVANCE_TRIGGER (61)—Advance trigger for dynamic acquisition.

Default Value: NIHSDIO_VAL_START_TRIGGER
triggerIdentifier ViConstString Describes the software trigger. For example, "ScriptTrigger0" could be the identifier for the Script trigger, or you could have an empty string for the Start and Reference triggers.

Defined Values

"ScriptTrigger0"
"ScriptTrigger1"
"ScriptTrigger2"
"ScriptTrigger3"
"" (empty string) or VI_NULL

Default Value: "" (empty string)

Return Value