RtGetProcessMSpace

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

Syntax

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

Parameters

hProcess

A handle to an RTSS process, as returned by RtCreateProcess, RtOpenProcess, or GetCurrentProcess. If NULL, the MSpaces requested are those of the Subsystem.

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

Returns TRUE if the function succeeds. Returns FALSE if the function fails.

Remarks

RTX64 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. When you call RtGetProcessMSpace in a Windows process with the HANDLE returned from GetCurrentProcess, the function returns the MSpace descriptors of the corresponding RTSS proxy process.

See Also:

RtQueryProcessMSpace

RtExpandMSpace

RtShrinkMSpace