Subsystem.ResetTriggers Method (MF_EVENT_KIND, Subsystem.TriggerKinds)

This method resets the specified triggers so that they do not happen for the specified kind of event (eventKind). Parameter triggers contains one or more of the flag enumerators from enumeration TriggerKinds specifying the triggers to be reset for this kind of event. If the Subsystem is not started, this method throws an exception of type RTX64Exception containing an explanatory error message. This method can be called when monitoring is stopped or started. It takes effect immediately. If any of the specified triggers are already reset, they remain reset. 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.

Session triggers set programmatically from monitor event MF_EVENT_KIND_CUSTOM are ignored.

The following kinds of monitoring events cannot have triggers set on them. Attempting to do so will cause an exception of type RTX64Exception to be thrown:

• MF_EVENT_KIND_RESERVED (Reserved)
• MF_EVENT_KIND_BUGCHECK_RTSS_RESERVED (Bugcheck RTSS)
• MF_EVENT_KIND_MARKER (Marker)
• MF_EVENT_KIND_SUBSYSTEM_STOP (Subsystem Stop)
• MF_EVENT_KIND_FAST_SEMAPHORE_ACQUIRE (Fast Semaphore Acquire)
• MF_EVENT_KIND_FAST_SEMAPHORE_RELEASE (Fast Semaphore Release)
• MF_EVENT_KIND_FAST_SEMAPHORE_RELEASE_ALL (Fast Semaphore Release All)
• MF_EVENT_KIND_WFSOEX_WAIT (WaitForSingleObjectEx Wait)
• MF_EVENT_KIND_WFMOEX_WAIT (WaitForMultipleObjectEx Wait)
• MF_EVENT_KIND_THREAD_SLEEP (Thread Sleep)

Namespace:  IntervalZero.RTX64.Monitor
Assembly:  IntervalZero.RTX64 (in IntervalZero.RTX64.dll) Version: 4.0.0.0 (File version: 4.5.0)

Syntax

public void ResetTriggers(
	MF_EVENT_KIND eventKind,
	Subsystem.TriggerKinds triggers
)

Public Sub ResetTriggers ( 
	eventKind As MF_EVENT_KIND,
	triggers As Subsystem.TriggerKinds
)

public:
virtual void ResetTriggers(
	MF_EVENT_KIND eventKind, 
	Subsystem.TriggerKinds triggers
) sealed

abstract ResetTriggers : 
        eventKind : MF_EVENT_KIND * 
        triggers : Subsystem.TriggerKinds -> unit 
override ResetTriggers : 
        eventKind : MF_EVENT_KIND * 
        triggers : Subsystem.TriggerKinds -> unit 

Exceptions

See Also