niHSDIO_ConfigurePatternMatchRefTriggerU32
Specific Function
C Function Prototype
ViStatus niHSDIO_ConfigurePatternMatchRefTriggerU32 (ViSession vi, ViConstString channelList, ViUInt32 pattern, ViInt32 triggerWhen, ViInt32 pretriggerSamples);
Purpose
Configures the Reference trigger for pattern-match triggering. If the Reference trigger asserts before all the pretrigger samples are acquired, then it is ignored.
Unlike niHSDIO_ConfigurePatternMatchRefTrigger which uses a string, this function uses a binary format to only represent high and low. If you require more choices for your pattern, use the niHSDIO_ConfigurePatternMatchRefTrigger function.
This function is only valid for acquisition sessions.
 |
Note The logic levels 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. |
| pattern | ViUInt32 | Specifies the binary pattern that activates the pattern match trigger under the conditions specified in triggerWhen. Bits on channels not specified in channelList are ignored. |
| 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 |
| pretriggerSamples | ViInt32 | Specifies the number of necessary pretrigger samples before the Reference trigger is acknowledged. |