MSPACE_INFO Structure

Structure MSPACE_INFO contains information for a single memory allocation space (MSpace).

Syntax

typedef struct _MSPACE_INFO {
    ULONG64 MSpacePeakUsage;
    ULONG64 MSpaceSize;
    ULONG64 MSpaceFree;
    ULONG64 MSpaceUsed;
    ULONG64 MaxContigFreeMem;
    ULONG64 NumFreeChunksInCache;
    ULONG64 CacheFree;
    ULONG64 CacheUsed;
    ULONG64 NumFreeRangesInPool;
    ULONG64 PoolFree;
    ULONG64 PoolUsed;
    ULONG64 AutoExpandSize;
    BOOL   AutoExpandEnabled;
} MSPACE_INFO, *PMSPACE_INFO;

Parameters

MSpacePeakUsage

The MSpace peak usage (statistical maximum, in bytes). This is the maximum amount of memory used during process execution when the call is made. This value may be greater than the current usage.

MSpaceSize

The total memory size, in bytes, in the MSpace. MSpaceSize = MSpaceFree + MSpaceUsed.

MSpaceFree

The total free memory size, in bytes, in the MSpace. MSpaceFree = PoolFree + CacheFree.

MSpaceUsed

The total used memory size, in bytes, in the MSpace. MSpaceUsed = PoolUsed - CacheFree.

MaxContigFreeMem

The maximum virtually contiguous free memory size, in bytes, in the MSpace.

NumFreeChunksInCache

The number of free chunks in the MSpace’s pool cache (count).

CacheFree

The amount of free memory, in bytes, in the MSpace’s pool cache.

CacheUsed

The amount of used memory, in bytes, in the MSpace’s pool cache.

NumFreeRangesInPool

The number of free ranges in the MSpace’s local pool (count).

PoolFree

The amount of free memory, in bytes, in the MSpace’s local pool.

PoolUsed

The amount of used memory, in bytes, in the MSpace’s pool cache.

AutoExpandSize

The minimum expandable size, in bytes, of the MSpace.

AutoExpandEnabled

Determines whether the MSpace will automatically expand (TRUE – enabled, FALSE - disabled).

Requirements

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