niHSDIO_ConfigurePatternMatchPauseTrigger
Specific Function
C Function Prototype
ViStatus niHSDIO_ConfigurePatternMatchPauseTrigger (ViSession vi, ViConstString channelList, ViConstString pattern, ViInt32 triggerWhen);
Purpose
Configures the Pause trigger for pattern-match triggering. This function is valid only for acquisition sessions.
Valid Syntax:
Both of the following examples are valid and do the same thing.
The order of channelList determines the order of the
pattern string.
- niHSDIO_ConfigurePatternMatchPauseTrigger (vi, "19-0", "0000 0XXX XX11 1111 1111");
- niHSDIO_ConfigurePatternMatchPauseTrigger (vi, "0-19", "1111 1111 11XX XXX0 0000");
 |
Note The values seen by pattern matching are affected by data interpretation. |
Parameters
| Name | Type | Description |
|---|---|---|
| vi | ViSession | This handle identifies your instrument session. vi was obtained from niHSDIO_InitAcquisitionSession. |
| channelList | ViConstString | This string specifies which channels are configured for pattern matching using the pattern string. The order of channels in the list determines the order of the pattern string. Ex. "0-19" and "19-0" are reverse of one another. |
| pattern | ViConstString | This string expression describes the pattern to be matched. The pattern specifies an edge
or level transition that must occur before the trigger is recognized. The first sample acquired
will be the first full sample following the configured transition. This expression is composed of characters:
The first character in the expression corresponds to the first channel in channelList. The number of characters in pattern must correspond to the number of channels specified in channelList or an error is returned. |
| triggerWhen | ViInt32 | Specifies when the trigger asserts. Defined Values NIHSDIO_VAL_PATTERN_MATCHES (36)—The trigger asserts when the pattern matches. NIHSDIO_VAL_PATTERN_DOES_NOT_MATCH (37)—The trigger asserts when the pattern does not match. Default Value: NIHSDIO_VAL_PATTERN_MATCHES |