PERFORMANCE_LEVEL Enumeration

Enumeration PERFORMANCE_LEVEL indicates the performance level of calling function RtQueryProcessMSpace.

Syntax

typedef enum _PERFORMANCE_LEVEL {
     LowestPerformanceLevel = 0,
     LowPerformanceLevel,
     NormalPerformanceLevel,
     HighPerformanceLevel,
     PerformanceLevelUndefined
} PERFORMANCE_LEVEL, * PPERFORMANCE_LEVEL;

Parameters

LowestPerformanceLevel

Fills in the provided structure and prints information on the specified MSpace, including chunk information within the local pool and pool cache. This option is non-deterministic.

LowPerformanceLevel

Fills in the provided structure and prints information on the specified MSpace. This option is non-deterministic.

NormalPerformanceLevel

Fills in the provided structure. For highly fragmented MSpace, this option has large latency.

HighPerformanceLevel

Fills in the following fields of the provided structure with approximate values based on existing trace information:

MSpacePeakUsage;

MSpaceSize;

MSpaceFree;

MSpaceUsed;

CacheFree;

CacheUsed;

PoolFree;

PoolUsed;

AutoExpandSize;

AutoExpandEnabled;

Zeroes the following fields of the provided structure due to lack of tracing information:

MaxContigFreeMem;

NumFreeChunksInCache;

NumFreeRangesInPool;

NOTE: The latency of this option is low and independent of fragmentation in the MSpace.

Requirements

Minimum Supported Version	RTX64 4.0
Header	Rtapi.h
Library	RtApi.lib (Windows), Rtx_Rtss.lib (RTSS)