Struct VirtualBlock 

pub struct VirtualBlock { /* private fields */ }

Virtual TLSF allocator; owns host metadata and no native objects.

Mutations require exclusive access. Drop releases Rust metadata only. This is not a Vulkan memory block or a pool with GPU lifetime tracking.

Implementations

impl VirtualBlock

pub fn new(size: u64) -> Result<Self, AllocError>

pub fn allocate( &mut self, size: u64, alignment: u64, strategy: PlacementStrategy, ) -> Result<VirtualAllocation, AllocError>

Allocate an aligned region using the chosen donor search order.

pub fn free( &mut self, allocation: &mut VirtualAllocation, ) -> Result<(), AllocError>

Release a matching live identity. No native resource is destroyed or waited on.

pub fn allocation_info( &self, allocation: &VirtualAllocation, ) -> Result<VirtualAllocationInfo, AllocError>

Validate identity/generation and return the current offset/size snapshot.

pub fn clear(&mut self)

Invalidate all tokens and restore the full range, retaining host capacity. Users of previously returned offsets must stop using them before reuse.

pub fn statistics(&self) -> VirtualBlockStats

Calculate detailed free-span statistics; this is not a constant-time hot path.