EventReader Class

This class provides functionality to read monitoring events from monitoring session log folders. Instances of subclasses of class MonitorEvent represent each event.

Inheritance Hierarchy

System.Object
  ntervalZero.MaxRT.wRTOS.Monitor.EventReader

Namespace:  IntervalZero.MaxRT.wRTOS.Monitor
Assembly:  IntervalZero.MaxRT.wRTOS (in IntervalZero.MaxRT.wRTOS.dll) Version: 1.0.0.0 (File version: 1.1.0)

Syntax

Copy
public class EventReader : IDisposable

 

The EventReader class exposes the following members.

Constructors

 

Name Description

Public method

EventReader

This constructor prepares this instance to read event data from the most recent monitoring session folder. To read event data from a different folder, use constructor EventReader (string).

Public method

EventReader (String)

This constructor prepares this instance to read event data from the monitoring session stored in the specified folder.

Properties

  Name Description

Public property

FirstTimeStamp

This property will return the first timestamp within the session. If the index has not been built yet it will return 0.

Public property

IsIndexBuilding

Public API to tell if the Index is currently being built

Public property

LastTimeStamp

This property will return the last timestamp within the session. If the Index has not been built yet it will return 0.

Public property

MaxCore

This property holds the highest processor number seen in the current session's event data.

Public property

PIDToPathname

This is a read-only property that returns a Dictionary that maps a real-time PID to the absolute pathname of the process's main module (i.e., the RTSS application).

Public property

SessionVersion

This is the version of the monitoring session data that is being read. Depending on the value returned by this property, various properties in subclasses of class MonitorEvent may be defined or undefined. See the documentation for each property for information about which fields are defined for which monitoring session versions.

Methods

  Name Description

Public method

CloseData

Closes the unmanaged OS handles used to access the contents of monitoring event session folders. This must be called by the client after all calls to method ReadEvents have finished and no more calls to ReadEvents will be made.

Public method

DeleteSession

Deletes the contents of the current Session. Once called this object will also be disposed of and cannot be used further. A new object should be instantiated.

Public method

Dispose

Public implementation of dispose,

Public method

GetEventReader

This method opens a monitor session file (.monx) or a monitor event file (.mev), which opens the Event Reader session.

Public method

GetProcessPathnameByPID

Returns the absolute pathname of the main module (the RTSS file) of the real-time process having the process ID specified by parameter pid.

Public method

ReadEvents

This method returns an array of MonitorEvents containing no more than the specified number of elements.

Public method

ResetToStart

Resets the event reader so the next call to EventReader.ReadEvents returns event(s) from the start of the monitoring session.

Events

 

Name Description

Public event

IndexFinishedBuilding

This event will be set once upon completion of the index being constructed. This event will only be set once and only if the index is not already constructed for the opened session.

See Also: