RtMonitorSetTriggers

RtMonitorSetTriggers transiently sets the event types that will trigger the start of a monitoring session.

Syntax

BOOL RtMonitorSetTriggers(
    const RT_MONITOR_TRIGGER_CONTROL * eventTriggers,
    size_t countEventTriggers,
    BOOL enable
);

Parameters

eventTriggers

An array of RT_MONITOR_TRIGGER_CONTROL structures that will either be set or unset as monitoring triggers based on parameter enable.

countEventTriggers

The number of elements in the array.

enable

Determines whether the events are enabled or disabled as trigger events.

Return Value

Returns TRUE if successful, otherwise it returns FALSE and sets the last error value.

REMarks

For operation MONITOR_CONTROL_SET_EVENT_TRIGGERS, the following kinds of monitoring events cannot be associated with triggers:

Attempts to associate one of the above event kinds with a trigger will cause RtMonitorSetTriggers to fail with ERROR_INVALID_PARAMETER.

Requirements

Minimum Supported Version

RTX64 3.6

Header

Rtapi.h

Library

rtx_rtss.lib (RTSS), rtapi.h (Windows)