RtGetProcessMSpace

RtGetProcessMSpace retrieves a descriptor of the external and internal memory allocation space (MSpace) for the specified process or the system process.

Syntax

BOOL RtGetProcessMSpace(
    HANDLE hProcess,
    mspace *ExtMSpace,
    mspace *IntMSpace
);

Parameters

hProcess

A handle to a process returned by RtCreateProcess, RtOpenProcess, or GetCurrentProcess. If NULL, the MSpaces requested are those of the kernel.

ExtMSpace

A pointer to an mspace to return the descriptor of the external MSpace for the specified process.

IntMSpace

A pointer to an mspace to return the descriptor of the internal MSpace for the specified process.

Return Value

If the function succeeds, it returns TRUE. If the function fails, it returns FALSE.

Remarks

eRTOS uses the descriptor to define a local memory allocation space MSpace. The MSpace descriptor is opaque to users.

Call RtGetProcessMSpace first whenever you need a MSpace descriptor for calling other RTAPIs.

See Also:

• RtQueryProcessMSpace
• RtExpandMSpace
• RtShrinkMSpace