RTFW_MONITOR_CONFIGURATION Structure

RTFW_MONITOR_CONFIGURATION represents the default configuration of the RTX64 Monitoring on Subsystem start.

Syntax

typedef struct _RTFW_MONITOR_CONFIGURATION(
    size_t Size;
    uint64_t MTBSize;
    bool AutoEnable;
    bool AutoStart;
    bool AutoRotateLogFiles;
    uint64_t MaximumSessionSize;
    TCHAR SessionFolder[MAX_PATH];
} RTFW_MONITOR_CONFIGURATION, * PRTFW_MONITOR_CONFIGURATION;

Members

Size

The size of this structure (in bytes). Client code must set this member to sizeof(RTFW_MONITOR_CONFIGURATION) before passing this structure to any function.

MTBSize

The size (in megabytes) of the Monitoring Transport Buffer (MTB), the internal buffer used to transport RTX64 Monitoring Framework events from real-time processors to Windows processors. This value must not exceed three-quarters of the amount of RAM in the machine. If this buffer fills up, monitoring events are lost, and a Data Lost monitoring event is generated. If Data Lost events occur, either enable fewer kinds of monitoring events or increase the size of this buffer (or both).

AutoEnable

Controls whether the RTX64 Monitoring Framework is automatically enabled when the RTX64 Subsystem starts. If this member is true, monitoring is automatically enabled at Subsystem start, otherwise it is not automatically enabled.

AutoStart

Controls whether the RTX64 Monitoring Framework is automatically started when the RTX64 Subsystem starts. If this member is true, monitoring is automatically started at Subsystem start, otherwise it is not automatically enabled.

IMPORTANT! The Monitoring Framework cannot be auto-started if member AutoEnable is false. Member AutoStart is ignored when member AutoEnable is false.

AutoRotateLogFiles

If true, the RTX64 Monitoring Framework will delete the oldest monitoring session log file when the maximum session folder size is reached. If false, monitoring will automatically stop once the MaximumSessionSize is reached.

MaximumSessionSize

The maximum size (in megabytes) that a monitoring session folder can occupy on disk. If this value is zero, monitoring events are not written to disk.

SessionFolder

The absolute pathname of the folder where RTX64 Monitoring Framework session folders are stored. Immediately after product installation, this is %ProgramData%\IntervalZero\Monitor\.

Requirements

Minimum Required Version	RTX64 3.4
Header	RtfwAPI.h
Library	RtfwAPI.lib