RTFW_LOCAL_MEMORY_CONFIGURATION Structure

RTFW_LOCAL_MEMORY_CONFIGURATION represents the configuration of the wRTOS Subsystem and its use of Local Memory MSpaces.

Syntax

Copy

typedef struct _RTFW_LOCAL_MEMORY_CONFIGURATION(
    size_t          Size;
    unsigned int    SystemExtMSpacePoolMinimumSize;
    bool            SystemExtMSpacePoolCommit;
    bool            SystemMSpacesPoolExpandable;
    unsigned int    SystemMSpacesPoolExpandSize;
    bool            SystemMSpacesPoolShrinkable;
    unsigned int    ProcessExtMSpacePoolMinimumSize;
    bool            ProcessMSpacesPoolExpandable;
    unsigned int    ProcessMSpacesPoolExpandSize;
    bool            ProcessMSpacesPoolShrinkable;
    bool            ZeroMemoryAtAllocation;
    unsigned int    SystemIntMSpacePoolMinimumSize;
    unsigned int    ProcessIntMSpacePoolMinimumSize;
} RTFW_LOCAL_MEMORY_CONFIGURATION, * PRTFW_LOCAL_MEMORY_CONFIGURATION;

Members

Size

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

SystemExtMSpacePoolMinimumSize

The minimum size, in kilobytes, of the local pool within the system process external MSpace. This value must be within the range 64 KB to 4,194,292 KB.

SystemExtMSpacePoolCommit

Commits the local pool within the system process external MSpace at startup.

SystemMSpacesPoolExpandable

If TRUE, the local pool within the system process MSpace is expandable by the amount specified by SystemMSpacesPoolExpandSize when depleted.

SystemMSpacesPoolExpandSize

The size, in kilobytes, by which to expand the local pool within the system process MSpace when SystemMSpacesPoolExpandable is set to TRUE. This value must be within the range 64 KB to 4,194,292 KB. It cannot be 0.

SystemMSpacesPoolShrinkable

If TRUE, the local pool within the system process MSpace is shrinkable.

ProcessExtMSpacePoolMinimumSize

The minimum size, in kilobytes, of the local pool within the RTSS process external MSpace. This value must be within the range 64 KB to 4,194,292 KB.

ProcessMSpacesPoolExpandable

If TRUE, the local pool within the RTSS process MSpace is expandable by the amount specified by ProcessMSpacesPoolExpandSize when depleted.

ProcessMSpacesPoolExpandSize

The size, in kilobytes, by which to expand the local pool within the RTSS process MSpace when ProcessMSpacesPoolExpandable is set to TRUE. This value must be within the range 64 KB to 4,194,292 KB.

ProcessMSpacesPoolShrinkable

If TRUE, the local pool within the RTSS process MSpace is shrinkable.

ZeroMemoryAtAllocation

If TRUE, the memory allocated by malloc or similar C-Runtime functions is initialized to zero according to the C99 specification, otherwise the memory is not initialized. See Zeroing Memory at Allocation for more information.

SystemIntMSpacePoolMinimumSize

The minimum size, in kilobytes, of the local pool within the system process internal MSpace. This value must be within the range 64 KB to 4,194,292 KB.

ProcessIntMSpacePoolMinimumSize

The minimum size, in kilobytes, of the local pool within the RTSS process internal MSpace. This value must be within the range 64 KB to 4,194,292 KB.

Requirements

Minimum supported version	Header	Library
wRTOS 1.0 SDK	RtfwApi.h	RtfwApi.lib