INtime SDK Help
GetRtSize
INtime SDK v7.1 > About INtime > INtime Kernel > Memory management > GetRtSize

Returns the number of bytes in a previously allocated memory area.

DWORD GetRtSize(
  RTHANDLE hSeg    // RTHANDLE for previously-created memory area
);

Parameters

hSeg
The RTHANDLE for a memory area. Must be a valid RT handle.

Remarks

Segments can be a maximum length of 4 Gbytes.

Return Values

A DWORD value giving the number of bytes in the segment.
If hSeg is the data segment of an XM process, then the returned value will be 0xffffffff, indicating a size of 4 GB.
Success.
0 (zero)
Failure. The handle passed in is invalid, or is not a segment handle. To determine the status, call GetLastRtError.

Status

E_OK 0x0000
No exceptional conditions occurred.
E_EXIST 0x0006
hSeg is not a handle for an existing object.
E_TYPE 0x8002
hSeg is not a handle for a memory object.

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/rt/include/rtbase.h rt.h rt.lib

Memory management system calls

See Also