Subsystem.SetTriggers Method (MF_EVENT_KIND, Subsystem.TriggerKinds) |
This method sets the specified triggers to happen when the specified kind of event (parameter eventKind) is generated. Parameter triggers contains one or more of the flag enumerators from enumeration TriggerKinds specifying the triggers to be set 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 set, they remain set. These flag enumerators can be mixed with each other using bitwise operators.
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)
The following monitoring events are not generated in RTX64 4.3 and later versions and will be silently ignored:
- MF_EVENT_KIND_CONTIGUOUS_MEMORY_ALLOC (Contiguous Memory Alloc)
- MF_EVENT_KIND_CONTIGUOUS_MEMORY_ALLOC_FAIL (Contiguous Memory Alloc Fail)
- MF_EVENT_KIND_CONTIGUOUS_MEMORY_SPECIFY_CACHE (Contiguous Memory Alloc Specify Cache)
- MF_EVENT_KIND_CONTIGUOUS_MEMORY_SPECIFY_CACHE_FAIL (Contiguous Memory Alloc Specify Cache Fail)
- MF_EVENT_KIND_CONTIGUOUS_MEMORY_FREE (Contiguous Memory Free)
- MF_EVENT_KIND_CONTIGUOUS_MEMORY_FAIL (Contiguous Memory Free Fail)
- MF_EVENT_KIND_LOCAL_MEMORY_EXPAND (Local Memory Expand)
- MF_EVENT_KIND_LOCAL_MEMORY_SHRINK (Local Memory Shrink)
- MF_EVENT_KIND_WINDOWS_MEMORY_ALLOC (Windows Memory Alloc)
- MF_EVENT_KIND_WINDOWS_MEMORY_ALLOC_FAIL (Windows Memory Alloc Fail)
- MF_EVENT_KIND_WINDOWS_MEMORY_FREE (Windows Memory Free)
- MF_EVENT_KIND_WINDOWS_MEMORY_FREE_FAIL (Windows Memory Free Fail)
Assembly: IntervalZero.RTX64 (in IntervalZero.RTX64.dll) Version: 4.0.0.0 (File version: 4.5.0)
Parameters
- eventKind
- Type: IntervalZero.RTX64.Monitor.MF_EVENT_KIND
- triggers
- Type: IntervalZero.RTX64.Monitor.Subsystem.TriggerKinds
Implements
IMonitorSubsystem.SetTriggers(MF_EVENT_KIND, Subsystem.TriggerKinds)Exception | Condition |
---|---|
RTX64Exception | Thrown if this method is used without the RTX64 Runtime installed. |