OS_GetTotalAllocSize

Syntax

#include <nitro/os.h>
u32 OS_GetTotalAllocSize( OSArenaId id, OSHeapHandle heap );
  

Arguments

id Arena ID of the arena for the heap from which the total size is obtained
heap Heap handle of the heap from which the total size is obtained

Return Values

The total size (in bytes) of the memory blocks allocated to the heap. The header is not included.

Description

Obtains the total size of the memory blocks allocated to the heap.

Set OS_CURRENT_HEAP_HANDLE in heap to specify the current heap.

The memory block headers are not included in the size value. The size refers to the size of the data regions. When the header can be included, use OS_GetTotalOccupiedSize() .

All allocated blocks are tracked down and calculated, so the time required for the process is proportional to the amount of memory blocks.

See Also

OS_InitAlloc, OS_GetTotalFreeSize, OS_GetMaxFreeSize
OS_GetTotalOccupiedSize

Revision History

2005/10/07 Divided into OS_GetTotalAllocSize and OS_GetTotalOccupiedSize.
2004/11/05 Initial version.


CONFIDENTIAL