DAQmxCfgDigPatternRefTrig

int32 DAQmxCfgDigPatternRefTrig (TaskHandle taskHandle, const char triggerSource[], const char triggerPattern[], int32 triggerWhen, uInt32 pretriggerSamples);

Purpose

Configures the task to stop the acquisition when the device acquires all pretrigger samples, matches or does not match a digital pattern, and acquires all posttrigger samples.

Parameters

Input
Name	Type	Description
taskHandle	TaskHandle	The task used in this function.
triggerSource	const char []	Specifies the physical channels to use for pattern matching. The order of the physical channels determines the order of the pattern. If a port is included, the order of the physical channels within the port is in ascending order.
triggerPattern	const char []	Specifies the digital pattern that must be met for the trigger to occur.
triggerWhen	int32	Specifies the conditions under which the trigger occurs. Value Description DAQmx_Val_PatternMatches Pattern matches DAQmx_Val_PatternDoesNotMatch Pattern does not match
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.