Struct GpuMemoryPool 

pub struct GpuMemoryPool { /* private fields */ }

GPU memory pool allocator.

Implementations

impl GpuMemoryPool

pub fn new(block_size: usize) -> Self

Create a new pool.

• block_size – size of each new backing block in bytes.

pub fn alloc( &mut self, size: usize, alignment: Alignment, ) -> Option<AllocationHandle>

Allocate size bytes with the given alignment.

Returns an AllocationHandle on success. If no existing block can satisfy the request, a new backing block is created.

pub fn free(&mut self, handle: &AllocationHandle)

Free a previously allocated handle.

pub fn stats(&self) -> &PoolStats

Current pool statistics.

pub fn block_count(&self) -> usize

Total number of backing blocks.

pub fn free_bytes(&self) -> usize

Total free bytes across all blocks.

pub fn reset(&mut self)

Reset the pool – all backing blocks are cleared.

pub fn defragment(&mut self) -> DefragResult

Defragment the pool by coalescing free ranges in all blocks and removing completely empty blocks.

This operation is O(B * R log R) where B = block count, R = free ranges. Call periodically in long-running sessions to reduce fragmentation.

Returns a DefragResult describing the work performed.

pub fn compact(&mut self) -> Option<CompactionPlan>

Compact the pool by migrating allocations from sparsely-used blocks into denser blocks, freeing up empty blocks.

This is a more aggressive form of defragment() — it returns a list of migrations (old_handle, new_handle) that the caller must apply to move data from old offsets to new offsets.

Returns None if compaction is not possible or not beneficial.

pub fn fragmentation_ratio(&self) -> f64

Calculate the fragmentation ratio (0.0 = no fragmentation, 1.0 = fully fragmented).

Defined as: 1 - (largest_free_contiguous / total_free). A value of 0.0 means all free memory is in one contiguous block.

pub fn shrink(&mut self) -> usize

Shrink the pool by removing empty blocks and trimming capacity.

Unlike defragment, this only removes blocks with zero live allocations.