Subsystem.SetTriggersForCustomEvents Method |
This method sets triggers for custom event kinds for event kind MF_EVENT_KIND_CUSTOM.
Parameter customEventKindTriggers specifies the triggers to be set for
1000 custom event kind values (0 to 999). This array must be exactly 1000 elements long,
otherwise an exception of type RTX64Exception is thrown. If the Subsystem is not
started, this method throws an exception of type RTX64Exception. This method can
be called when monitoring is stopped or started. It takes effect immediately. If any
of the specified triggers are already set, they remain set.
Triggers do not persist after the RTX64 Subsystem stops. If persistence is desired, it
is the client's responsibility to save trigger state before the Subsystem stops and to
restore it when the Subsystem starts.
This method is thread-safe and executes atomically across all processes with respect to
all other trigger-related methods.
IMPORTANT: This method only accumulates new triggers. It never resets a trigger.
Thus, if a given custom event kind has trigger X set, and this method is called to set
only trigger Y for that custom event kind, then that custom event kind ends up with both
trigger X and Y set.
Namespace:
IntervalZero.RTX64.MonitorAssembly: IntervalZero.RTX64 (in IntervalZero.RTX64.dll) Version: 4.0.0.0 (File version: 4.5.0)
Syntax
public void SetTriggersForCustomEvents( Subsystem.TriggerKinds[] customEventKindTriggers )
Parameters
- customEventKindTriggers
- Type: IntervalZero.RTX64.Monitor.Subsystem.TriggerKinds
Implements
IMonitorSubsystem.SetTriggersForCustomEvents(Subsystem.TriggerKinds)Exceptions
Exception | Condition |
---|---|
RTX64Exception | Thrown if this method is used without the RTX64 Runtime installed. |
See Also