niHSDIO_ConfigurePatternMatchStartTriggerU32
- Updated2023-02-21
- 2 minute(s) read
ViStatus = niHSDIO_ConfigurePatternMatchStartTriggerU32 ( ViSession vi, ViConstString channelList, ViUInt32 pattern, ViInt32 triggerWhen);
Purpose
Configures the Start trigger for pattern-match triggering.
Unlike the niHSDIO_ConfigurePatternMatchStartTrigger function, 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_ConfigurePatternMatchStartTrigger function.
This function is valid only for acquisition operations.
 |
Note The logic levels seen by pattern matching are affected by data interpretation. |
Related topics:
Parameters
| Input | ||
| Name | Type | Description |
| vi | ViSession | Identifies your instrument session. vi was obtained from the niHSDIO_InitAcquisitionSession or niHSDIO_InitGenerationSession function. |
| Channel List | ViConstString | This string specifies which channels are configured for pattern matching using the pattern value. |
| 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. |
| Trigger When | 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. |
Return Value
| Name | Type | Description | ||||||||
| Status | ViStatus | Reports the status of this operation. To obtain a text description of the status code, call the niHSDIO_error_message function. To obtain additional information concerning the error condition, use the niHSDIO_GetError and niHSDIO_ClearError functions. The general meaning of the status code is as follows:
|