Difference between revisions of "Unit HeapManager"

From Ultibo.org
Jump to: navigation, search
Line 35: Line 35:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 47: Line 47:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 266: Line 266:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 302: Line 302:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 326: Line 326:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 350: Line 350:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 374: Line 374:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 398: Line 398:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 422: Line 422:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 446: Line 446:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 470: Line 470:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 494: Line 494:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 506: Line 506:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 518: Line 518:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 530: Line 530:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 590: Line 590:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 614: Line 614:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 638: Line 638:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 662: Line 662:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 686: Line 686:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 710: Line 710:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 734: Line 734:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 758: Line 758:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 782: Line 782:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 806: Line 806:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 830: Line 830:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 854: Line 854:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 905: Line 905:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 956: Line 956:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 980: Line 980:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 992: Line 992:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,004: Line 1,004:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,016: Line 1,016:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,028: Line 1,028:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,040: Line 1,040:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,052: Line 1,052:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,076: Line 1,076:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,100: Line 1,100:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,124: Line 1,124:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,136: Line 1,136:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,148: Line 1,148:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,577: Line 1,577:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,589: Line 1,589:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,613: Line 1,613:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,625: Line 1,625:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,637: Line 1,637:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,649: Line 1,649:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,661: Line 1,661:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,673: Line 1,673:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,685: Line 1,685:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,697: Line 1,697:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,712: Line 1,712:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,724: Line 1,724:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,736: Line 1,736:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,748: Line 1,748:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,760: Line 1,760:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,772: Line 1,772:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,784: Line 1,784:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}
Line 1,796: Line 1,796:
 
|-
 
|-
 
! '''Note'''
 
! '''Note'''
−
| To be documented
+
| None documented
 
|-
 
|-
 
|}
 
|}

Revision as of 05:28, 26 September 2016

Return to Unit Reference


Description

To be documented

Constants

To be documented

Type definitions

To be documented

Public variables

To be documented

Function declarations


Initialization functions 

procedure RegisterMemoryManager;
Description: To be documented
Note None documented 


procedure RegisterHeapBlock(Address:Pointer; Size:PtrUInt);
Description: To be documented
Note None documented 


function RequestHeapBlock(Hint:Pointer; Size:PtrUInt; Flags,Affinity:LongWord):Pointer;
Description: Request registration a Heap Block with specified flags and affinity within an existing block
Hint The hint provides the requested base address of the heap block but may be overridden by the memory manager if the block is already partially or fully allocated, pass nil if any heap block is suitable
Size The size provides the requested size of the heap block. Size must be a power of 2 and both Hint and the returned pointer must be aligned on a multiple of HEAP_REQUEST_ALIGNMENT. Flags provides the heap block flags such as shared, local, code, device, nocache etc.
Affinity The affinity provides the processor affinity mask, a mask of 0 indicates no specific processor
Return The return is the heap block that has been registered or nil if the request failed
Note To allocate this memory use GetMemEx / AllocMemEx etc. The return value points directly to the heap block, to access the memory referenced by the heap block you must add SizeOf(THeapBlock) to this value. 


function RequestSharedHeapBlock(Hint:Pointer; Size:PtrUInt):Pointer;
Description: Request registration of a Shared Heap Block within an existing block
Hint The hint provides the requested base address of the shared heap block but may be overridden by the memory manager if the block is already partially or fully allocated, pass nil if any heap block is suitable
Size The size provides the requested size of the heap block. Size must be a power of 2 and both Hint and the returned pointer must be aligned on a multiple of HEAP_REQUEST_ALIGNMENT.
Return The return is the heap block that has been marked as shared or nil if the request failed (the memory management unit should mark this region of memory as sharable)
Note To allocate shared memory use GetSharedMem / AllocSharedMem etc. The return value points directly to the heap block, to access the memory referenced by the heap block you must add SizeOf(THeapBlock) to this value. 


function RequestLocalHeapBlock(Hint:Pointer; Size:PtrUInt; Affinity:LongWord):Pointer;
Description: Request registration of a Local Heap Block within an existing block
Hint The hint provides a requested base address of the local heap block but may be overridden by the memory manager if the block is already partially or fully allocated, pass nil if any heap block is suitable
Size The size provides the requested size of the heap block. Size must be a power of 2 and both Hint and the returned pointer must be aligned on a multiple of HEAP_REQUEST_ALIGNMENT.
Affinity The affinity provides the processor affinity mask, a mask of 0 indicates no specific processor
Return The return is the heap block that has been marked as local or nil if the request failed (The memory management unit should mark this region of memory as local or non global)
Note To allocate local memory use GetLocalMem / AllocLocalMem etc. The return value points directly to the heap block, to access the memory referenced by the heap block you must add SizeOf(THeapBlock) to this value. 


function RequestCodeHeapBlock(Hint:Pointer; Size:PtrUInt; Affinity:LongWord):Pointer;
Description: Request registration of a Code Heap Block within an existing block
Hint The hint provides a requested base address of the code heap block but may be overridden by the memory manager if the block is already partially or fully allocated, pass nil if any heap block is suitable
Size The size provides the requested size of the heap block. Size must be a power of 2 and both Hint and the returned pointer must be aligned on a multiple of HEAP_REQUEST_ALIGNMENT.
Affinity The affinity provides the processor affinity mask, a mask of 0 indicates no specific processor
Return The return is the heap block that has been marked as code or nil if the request failed (The memory management unit should mark this region of memory as executable)
Note To allocate code memory use GetCodeMem / AllocCodeMem etc. The return value points directly to the heap block, to access the memory referenced by the heap block you must add SizeOf(THeapBlock) to this value. 


function RequestDeviceHeapBlock(Hint:Pointer; Size:PtrUInt):Pointer;
Description: Request registration of a Device Heap Block within an existing block
Hint The hint provides the requested base address of the device heap block but may be overridden by the memory manager if the block is already partially or fully allocated, pass nil if any heap block is suitable
Size The size provides the requested size of the heap block. Size must be a power of 2 and both Hint and the returned pointer must be aligned on a multiple of HEAP_REQUEST_ALIGNMENT.
Return The return is the heap block that has been marked as device or nil if the request failed (The memory management unit should mark this region of memory as sharable)
Note To allocate device memory use GetDeviceMem / AllocDeviceMem etc. The return value points directly to the heap block, to access the memory referenced by the heap block you must add SizeOf(THeapBlock) to this value. 


function RequestNoCacheHeapBlock(Hint:Pointer; Size:PtrUInt):Pointer;
Description: Request registration of a Non Cached Heap Block within an existing block
Hint The hint provides the requested base address of the non cached heap block but may be overridden by the memory manager if the block is already partially or fully allocated, pass nil if any heap block is suitable
Size The size provides the requested size of the heap block. Size must be a power of 2 and both Hint and the returned pointer must be aligned on a multiple of HEAP_REQUEST_ALIGNMENT.
Return The return is the heap block that has been marked as non cached or nil if the request failed (The memory management unit should mark this region of memory as sharable)
Note To allocate non cached memory use GetNoCacheMem / AllocNoCacheMem etc. The return value points directly to the heap block, to access the memory referenced by the heap block you must add SizeOf(THeapBlock) to this value. 


function RequestNonSharedHeapBlock(Hint:Pointer; Size:PtrUInt):Pointer;
Description: Request registration of a Non Shared Heap Block within an existing block
Hint The hint provides the requested base address of the non shared heap block but may be overridden by the memory manager if the block is already partially or fully allocated, pass nil if any heap block is suitable
Size The size provides the requested size of the heap block. Size must be a power of 2 and both Hint and the returned pointer must be aligned on a multiple of HEAP_REQUEST_ALIGNMENT.
Return The return is the heap block that has been marked as non shared or nil if the request failed (The memory management unit should mark this region of memory as sharable)
Note To allocate non shared memory use GetNonSharedMem / AllocNonSharedMem etc. The return value points directly to the heap block, to access the memory referenced by the heap block you must add SizeOf(THeapBlock) to this value. 


function RequestIRQHeapBlock(Hint:Pointer; Size:PtrUInt; Affinity:LongWord):Pointer;
Description: Request registration of an IRQ Heap Block within an existing block
Hint The hint provides a requested base address of the IRQ heap block but may be overridden by the memory manager if the block is already partially or fully allocated, pass nil if any heap block is suitable
Size The size provides the requested size of the heap block. Size must be a power of 2 and both Hint and the returned pointer must be aligned on a multiple of HEAP_REQUEST_ALIGNMENT.
Affinity The affinity provides the processor affinity mask, a mask of 0 indicates no specific processor
Return The return is the heap block that has been marked as IRQ or nil if the request failed
Note To allocate IRQ memory use GetIRQMem / AllocIRQMem etc. The return value points directly to the heap block, to access the memory referenced by the heap block you must add SizeOf(THeapBlock) to this value. 


function RequestFIQHeapBlock(Hint:Pointer; Size:PtrUInt; Affinity:LongWord):Pointer;
Description: Request registration of an FIQ Heap Block within an existing block
Hint The hint provides a requested base address of the FIQ heap block but may be overridden by the memory manager if the block is already partially or fully allocated, pass nil if any heap block is suitable
Size The size provides the requested size of the heap block. Size must be a power of 2 and both Hint and the returned pointer must be aligned on a multiple of HEAP_REQUEST_ALIGNMENT.
Affinity The affinity provides the processor affinity mask, a mask of 0 indicates no specific processor
Return The return is the heap block that has been marked as FIQ or nil if the request failed
Note To allocate FIQ memory use GetFIQMem / AllocFIQMem etc. The return value points directly to the heap block, to access the memory referenced by the heap block you must add SizeOf(THeapBlock) to this value.


Heap functions 

function GetMemEx(Size:PtrUInt; Flags,Affinity:LongWord):Pointer;
Description: Allocate a block of memory with the flags and affinity requested
Note None documented 


function GetAlignedMem(Size,Alignment:PtrUInt):Pointer;
Description: Allocate a block of normal memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function GetAlignedMemEx(Size,Alignment:PtrUInt; Flags,Affinity:LongWord):Pointer;
Description: Allocate a block of memory aligned on a multiple of the alignment value with the flags and affinity requested
Alignment The alignment must be a multiple of the minimum alignment configuration 


function GetSharedMem(Size:PtrUInt):Pointer;
Description: Allocate a block of shared memory
Note None documented 


function GetSharedAlignedMem(Size,Alignment:PtrUInt):Pointer;
Description: Allocate a block of shared memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function GetLocalMem(Size:PtrUInt; Affinity:LongWord):Pointer;
Description: Allocate a block of local memory
Note None documented 


function GetLocalAlignedMem(Size,Alignment:PtrUInt; Affinity:LongWord):Pointer;
Description: Allocate a block of local memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function GetCodeMem(Size:PtrUInt; Affinity:LongWord):Pointer;
Description: Allocate a block of code memory
Note None documented 


function GetCodeAlignedMem(Size,Alignment:PtrUInt; Affinity:LongWord):Pointer;
Description: Allocate a block of code memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function GetDeviceMem(Size:PtrUInt):Pointer;
Description: Allocate a block of device memory
Note None documented 


function GetDeviceAlignedMem(Size,Alignment:PtrUInt):Pointer;
Description: Allocate a block of device memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function GetNoCacheMem(Size:PtrUInt):Pointer;
Description: Allocate a block of non cached memory
Note None documented 


function GetNoCacheAlignedMem(Size,Alignment:PtrUInt):Pointer;
Description: Allocate a block of non cached memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function GetNonSharedMem(Size:PtrUInt):Pointer;
Description: Allocate a block of non shared memory
Note None documented 


function GetNonSharedAlignedMem(Size,Alignment:PtrUInt):Pointer;
Description: Allocate a block of non shared memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function GetIRQMem(Size:PtrUInt; Affinity:LongWord):Pointer;
Description: Allocate a block of IRQ memory
Note None documented 


function GetIRQAlignedMem(Size,Alignment:PtrUInt; Affinity:LongWord):Pointer;
Description: Allocate a block of IRQ memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function GetFIQMem(Size:PtrUInt; Affinity:LongWord):Pointer;
Description: Allocate a block of FIQ memory
Note None documented 


function GetFIQAlignedMem(Size,Alignment:PtrUInt; Affinity:LongWord):Pointer;
Description: Allocate a block of FIQ memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function FreeIRQMem(Addr:Pointer):PtrUInt;
Description: Free a block of IRQ memory
Note None documented 


function FreeFIQMem(Addr:Pointer):PtrUInt;
Description: Free a block of FIQ memory
Note None documented 


function AllocMemEx(Size:PtrUInt; Flags,Affinity:LongWord):Pointer;
Description: Allocate and clear a block of memory with the flags and affinity requested
Note None documented 


function ReAllocMemEx(var Addr:Pointer; Size:PtrUInt; Flags,Affinity:LongWord):Pointer;
Description: Reallocate a block of memory with the flags and affinity requested
Note None documented 


function AllocAlignedMem(Size,Alignment:PtrUInt):Pointer;
Description: Allocate and clear a block of normal memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function AllocAlignedMemEx(Size,Alignment:PtrUInt; Flags,Affinity:LongWord):Pointer;
Description: Allocate and clear a block of normal memory aligned on a multiple of the alignment value with the flags and affinity requested
Alignment The alignment must be a multiple of the minimum alignment configuration 


function ReAllocAlignedMem(var Addr:Pointer; Size,Alignment:PtrUInt):Pointer;
Description: Reallocate a block of normal memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function ReAllocAlignedMemEx(var Addr:Pointer; Size,Alignment:PtrUInt; Flags,Affinity:LongWord):Pointer;
Description: Reallocate a block of memory aligned on a multiple of the alignment value with the flags and affinity requested
Alignment The alignment must be a multiple of the minimum alignment configuration 


function AllocSharedMem(Size:PtrUInt):Pointer;
Description: Allocate and clear a block of shared memory
Note None documented 


function AllocSharedAlignedMem(Size,Alignment:PtrUInt):Pointer;
Description: Allocate and clear a block of shared memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function ReAllocSharedMem(var Addr:Pointer; Size:PtrUInt):Pointer;
Description: Reallocate a block of shared memory
Note None documented 


function ReAllocSharedAlignedMem(var Addr:Pointer; Size,Alignment:PtrUInt):Pointer;
Description: Reallocate a block of shared memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function AllocLocalMem(Size:PtrUInt; Affinity:LongWord):Pointer;
Description: Allocate and clear a block of local memory
Note None documented 


function AllocLocalAlignedMem(Size,Alignment:PtrUInt; Affinity:LongWord):Pointer;
Description: Allocate and clear a block of local memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function ReAllocLocalMem(var Addr:Pointer; Size:PtrUInt; Affinity:LongWord):Pointer;
Description: Reallocate a block of local memory
Note None documented 


function ReAllocLocalAlignedMem(var Addr:Pointer; Size,Alignment:PtrUInt; Affinity:LongWord):Pointer;
Description: Reallocate a block of local memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function AllocCodeMem(Size:PtrUInt; Affinity:LongWord):Pointer;
Description: Allocate and clear a block of code memory
Note None documented 


function AllocCodeAlignedMem(Size,Alignment:PtrUInt; Affinity:LongWord):Pointer;
Description: Allocate and clear a block of code memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function ReAllocCodeMem(var Addr:Pointer; Size:PtrUInt; Affinity:LongWord):Pointer;
Description: Reallocate a block of code memory
Note None documented 


function ReAllocCodeAlignedMem(var Addr:Pointer; Size,Alignment:PtrUInt; Affinity:LongWord):Pointer;
Description: Reallocate a block of code memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function AllocDeviceMem(Size:PtrUInt):Pointer;
Description: Allocate and clear a block of device memory
Note None documented 


function AllocDeviceAlignedMem(Size,Alignment:PtrUInt):Pointer;
Description: Allocate and clear a block of device memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function ReAllocDeviceMem(var Addr:Pointer; Size:PtrUInt):Pointer;
Description: Reallocate a block of device memory
Note None documented 


function ReAllocDeviceAlignedMem(var Addr:Pointer; Size,Alignment:PtrUInt):Pointer;
Description: Reallocate a block of device memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function AllocNoCacheMem(Size:PtrUInt):Pointer;
Description: Allocate and clear a block of non cached memory
Note None documented 


function AllocNoCacheAlignedMem(Size,Alignment:PtrUInt):Pointer;
Description: Allocate and clear a block of non cached memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function ReAllocNoCacheMem(var Addr:Pointer; Size:PtrUInt):Pointer;
Description: Reallocate a block of non cached memory
Note None documented 


function ReAllocNoCacheAlignedMem(var Addr:Pointer; Size,Alignment:PtrUInt):Pointer;
Description: Reallocate a block of non cached memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function AllocNonSharedMem(Size:PtrUInt):Pointer;
Description: Allocate and clear a block of non shared memory
Note None documented 


function AllocNonSharedAlignedMem(Size,Alignment:PtrUInt):Pointer;
Description: Allocate and clear a block of non shared memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function ReAllocNonSharedMem(var Addr:Pointer; Size:PtrUInt):Pointer;
Description: Reallocate a block of non shared memory
Note None documented 


function ReAllocNonSharedAlignedMem(var Addr:Pointer; Size,Alignment:PtrUInt):Pointer;
Description: Reallocate a block of non shared memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function AllocIRQMem(Size:PtrUInt; Affinity:LongWord):Pointer;
Description: Allocate and clear a block of IRQ memory
Note The memory must be freed using FreeIRQMem 


function AllocIRQAlignedMem(Size,Alignment:PtrUInt; Affinity:LongWord):Pointer;
Description: Allocate and clear a block of IRQ memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration
Note The memory must be freed using FreeIRQMem 


function ReAllocIRQMem(var Addr:Pointer; Size:PtrUInt; Affinity:LongWord):Pointer;
Description: Reallocate a block of IRQ memory
Note None documented 


function ReAllocIRQAlignedMem(var Addr:Pointer; Size,Alignment:PtrUInt; Affinity:LongWord):Pointer;
Description: Reallocate a block of IRQ memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function AllocFIQMem(Size:PtrUInt; Affinity:LongWord):Pointer;
Description: Allocate and clear a block of FIQ memory
Note The memory must be freed using FreeFIQMem 


function AllocFIQAlignedMem(Size,Alignment:PtrUInt; Affinity:LongWord):Pointer;
Description: Allocate and clear a block of FIQ memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration
Note The memory must be freed using FreeFIQMem 


function ReAllocFIQMem(var Addr:Pointer; Size:PtrUInt; Affinity:LongWord):Pointer;
Description: Reallocate a block of FIQ memory
Note None documented 


function ReAllocFIQAlignedMem(var Addr:Pointer; Size,Alignment:PtrUInt; Affinity:LongWord):Pointer;
Description: Reallocate a block of FIQ memory aligned on a multiple of the alignment value
Alignment The alignment must be a multiple of the minimum alignment configuration 


function SizeIRQMem(Addr:Pointer):PtrUInt;
Description: Return the size of an allocated block of IRQ memory
Note None documented 


function SizeFIQMem(Addr:Pointer):PtrUInt;
Description: Return the size of an allocated block of FIQ memory
Note None documented 


function MemFlags(Addr:Pointer):LongWord;
Description: Return the flags of an allocated block of memory
Note None documented 


function MemFlagsIRQ(Addr:Pointer):LongWord;
Description: Return the flags of an allocated block of IRQ memory
Note None documented 


function MemFlagsFIQ(Addr:Pointer):LongWord;
Description: Return the flags of an allocated block of FIQ memory
Note None documented 


function GetHeapStatistics:THeapStatistics;
Description: Return detailed statistics for the heap manager
Note None documented 


function GetHeapBlockCount(State:LongWord):LongWord;
Description: Get the total number of current heap blocks based on state
Note None documented 


function GetHeapBlockCountEx(State,Flags,Affinity:LongWord):LongWord;
Description: Get the number of current heap blocks based on state, flags and affinity
Note This uses the block list (not the Free/Used/Small lists) in order to account for all blocks 


function GetHeapBlockMin(State:LongWord):LongWord;
Description: Get the minimum size of current heap blocks based on state
Note None documented 


function GetHeapBlockMinEx(State,Flags,Affinity:LongWord):LongWord;
Description: Get the minimum size of current heap blocks based on state, flags and affinity
Note This uses the block list (not the Free/Used/Small lists) in order to account for all blocks 


function GetHeapBlockMax(State:LongWord):LongWord;
Description: Get the maximum size of current heap blocks based on state
Note None documented 


function GetHeapBlockMaxEx(State,Flags,Affinity:LongWord):LongWord;
Description: Get the maximum size of current heap blocks based on state, flags and affinity
Note This uses the block list (not the Free/Used/Small lists) in order to account for all blocks 


function CreateHeapSnapshot(State:LongWord):PHeapSnapshot;
Description: To be documented
Note None documented 


function CreateHeapSnapshotEx(State,Flags,Affinity:LongWord):PHeapSnapshot;
Description: To be documented
Note None documented 


function DestroyHeapSnapshot(Snapshot:PHeapSnapshot):LongWord;
Description: To be documented
Note None documented


Internal functions 

function GetHeapBlock(Address:Pointer):PHeapBlock;
Description: Get the Heap Block referenced by Address
Note Address has already been normalized to include the Heap Block. Caller must hold the heap lock. 


function FindHeapBlock(Address:Pointer; Size:PtrUInt):PHeapBlock;
Description: Find the Heap Block containing Address up to the Size specified
Note Address has already been normalized to include the Heap Block. Caller must hold the heap lock. 


function AddHeapBlock(Block:PHeapBlock):Boolean;
Description: Add a heap block, sorted by ascending Address order
Note Caller must hold the heap lock 


function SplitHeapBlock(Block:PHeapBlock; Size:PtrUInt):PHeapBlock;
Description: Split a heap block at the size indicated
Return Return The return is the split portion of the block
Note Caller must remove block from the free list. Caller must add split block to the free list. Caller must hold the heap lock. 


function MergeHeapBlock(Block:PHeapBlock):PHeapBlock;
Description: Merge a heap block with Prev or Next blocks if free
Return The return is the merged result of the blocks
Note Caller must remove block from the free list. Caller must add merged block to the free list. Caller must hold the heap lock. 


function GetFreeBlock(Size:PtrUInt):PHeapBlock;
Description: Get a free block of at least the size indicated
Size The size has already been normalized to alignment and includes the size of the Heap Block
Note Caller must hold the heap lock 


function GetFreeBlockEx(Size:PtrUInt; Flags,Affinity:LongWord):PHeapBlock;
Description: Get a free block of at least the size indicated with the flags and affinity requested
Size The size has already been normalized to alignment and includes the size of the Heap Block
Note Caller must hold the heap lock 


function FindFreeBlock(Size:PtrUInt):PHeapBlock;
Description: Find a free block of at least the size indicated with no flags or affinity which is alignable to the HEAP_REQUEST_ALIGNMENT value
Size The size is the exact size and has not been normalized
Note Caller must hold the heap lock 


function AddFreeBlock(Block:PHeapBlock):Boolean;
Description: Add a free block, sorted by ascending Size order
Note Caller must hold the heap lock 


function RemoveFreeBlock(Block:PHeapBlock):Boolean;
Description: Remove a free block
Note Caller must hold the heap lock 


function GetUsedBlock(Address:Pointer):PHeapBlock;
Description: Get a used block by address
Address The address has already been normalized to include the Heap Block
Note Caller must hold the heap lock 


function CheckUsedBlock(Address:Pointer):Boolean;
Description: Check a used block by address
Address The address has already been normalized to include the Heap Block
Note Caller must hold the heap lock 


function AddUsedBlock(Block:PHeapBlock):Boolean;
Description: Add a used block
Note Caller must hold the heap lock 


function RemoveUsedBlock(Block:PHeapBlock):Boolean;
Description: Remove a used block
Note Caller must hold the heap lock 


function GetIRQBlock(Address:Pointer):PHeapBlock;
Description: Get the IRQ Heap Block referenced by Address
Address The address has already been normalized to include the IRQ Heap Block
Note Caller must hold the IRQ heap lock 


function CheckIRQBlock(Address:Pointer):Boolean;
Description: Check the IRQ Heap Block referenced by Address
Address The address has already been normalized to include the IRQ Heap Block
Note Caller must hold the IRQ heap lock 


function AddIRQBlock(Block:PHeapBlock):Boolean;
Description: Add an IRQ heap block, sorted by ascending Address order
Note Caller must hold the IRQ heap lock 


function SplitIRQBlock(Block:PHeapBlock; Size:PtrUInt):PHeapBlock;
Description: Split an IRQ heap block at the size indicated
Return The return is the split portion of the block
Note Caller must remove block from the IRQ free list. Caller must add split block to the IRQ free list. Caller must hold the IRQ heap lock. 


function MergeIRQBlock(Block:PHeapBlock):PHeapBlock;
Description: Merge an IRQ heap block with Prev or Next blocks if free
Return The return is the merged result of the blocks
Note Caller must remove block from the IRQ free list. Caller must add merged block to the IRQ free list. Caller must hold the IRQ heap lock. 


function GetFreeIRQBlock(Size:PtrUInt; Affinity:LongWord):PHeapBlock;
Description: Get a free IRQ block of at least the size indicated
Size The size has already been normalized to alignment and includes the size of the IRQ Heap Block
Note Caller must hold the IRQ heap lock 


function AddFreeIRQBlock(Block:PHeapBlock):Boolean;
Description: Add a free IRQ block, sorted by ascending Size order
Note Caller must hold the IRQ heap lock 


function RemoveFreeIRQBlock(Block:PHeapBlock):Boolean;
Description: Remove a free IRQ block
Note Caller must hold the IRQ heap lock 


function GetFIQBlock(Address:Pointer):PHeapBlock;
Description: Get the FIQ Heap Block referenced by Address
Address The address has already been normalized to include the FIQ Heap Block
Note Caller must hold the FIQ heap lock 


function CheckFIQBlock(Address:Pointer):Boolean;
Description: Check the FIQ Heap Block referenced by Address
Address The address has already been normalized to include the FIQ Heap Block
Note Caller must hold the FIQ heap lock 


function AddFIQBlock(Block:PHeapBlock):Boolean;
Description: Add an FIQ heap block, sorted by ascending Address order
Note Caller must hold the FIQ heap lock 


function SplitFIQBlock(Block:PHeapBlock; Size:PtrUInt):PHeapBlock;
Description: Split an FIQ heap block at the size indicated
Return The return is the split portion of the block
Note Caller must remove block from the FIQ free list. Caller must add split block to the FIQ free list. Caller must hold the FIQ heap lock. 


function MergeFIQBlock(Block:PHeapBlock):PHeapBlock;
Description: Merge an FIQ heap block with Prev or Next blocks if free
Return The return is the merged result of the blocks
Note Caller must remove block from the FIQ free list. Caller must add merged block to the FIQ free list. Caller must hold the FIQ heap lock. 


function GetFreeFIQBlock(Size:PtrUInt; Affinity:LongWord):PHeapBlock;
Description: Get a free FIQ block of at least the size indicated
Size The size has already been normalized to alignment and includes the size of the FIQ Heap Block
Note Caller must hold the FIQ heap lock 


function AddFreeFIQBlock(Block:PHeapBlock):Boolean;
Description: Add a free FIQ block, sorted by ascending Size order
Note Caller must hold the FIQ heap lock 


function RemoveFreeFIQBlock(Block:PHeapBlock):Boolean;
Description: Remove a free FIQ block
Note Caller must hold the FIQ heap lock


RTL heap manager functions 

function SysGetMem(Size:PtrUInt):Pointer;
Description: Allocate a block of normal memory
Note None documented 


function SysFreeMem(Addr:Pointer):PtrUInt;
Description: Free a block of memory
Note None documented 


function SysFreeMemSize(Addr:Pointer; Size:PtrUInt):PtrUInt;
Description: Free a block of memory
Note Size is not currently used 


function SysAllocMem(Size:PtrUInt):Pointer;
Description: Allocate and clear a block of normal memory
Note None documented 


function SysReAllocMem(var Addr:Pointer; Size:PtrUInt):Pointer;
Description: Reallocate a block of normal memory
Note None documented 


function SysSizeMem(Addr:Pointer):PtrUInt;
Description: Return the size of an allocated block of memory
Note None documented 


procedure SysInitThread;
Description: Initialize thread specific heap information
Note None documented 


procedure SysDoneThread;
Description: Finalize thread specific heap information
Note None documented 


procedure SysRelocateHeap;
Description: Relocate heap data
Note None documented 


function SysGetHeapStatus:THeapStatus;
Description: Return status information for the heap manager
Note None documented 


function SysGetFPCHeapStatus:TFPCHeapStatus;
Description: Return status information for the heap manager
Note None documented


Helper functions 

procedure AcquireHeapLock; inline;
Description: To be documented
Note None documented 


procedure ReleaseHeapLock; inline;
Description: To be documented
Note None documented 


procedure AcquireHeapIRQLock; inline;
Description: To be documented
Note None documented 


procedure ReleaseHeapIRQLock; inline;
Description: To be documented
Note None documented 


procedure AcquireHeapFIQLock; inline;
Description: To be documented
Note None documented 


procedure ReleaseHeapFIQLock; inline;
Description: To be documented
Note None documented 


procedure RegisterHeapLock(const Lock:THeapLock);
Description: To be documented
Note None documented 


function HeapStateToString(State:LongWord):String;
Description: To be documented
Note None documented


Return to Unit Reference

Retrieved from "https://ultibo.org/mediawiki_ultibo_org/index.php?title=Unit_HeapManager&oldid=991"