Struct PinnedMemoryAllocController 

pub struct PinnedMemoryAllocController { /* private fields */ }

Hands out a pinned allocation as Bytes, keeping the allocation alive for as long as the bytes are.

The binding is held and never read: dropping it is what returns the pages to the pool, so a caller that still has the slice still has the memory.

Implementations

impl PinnedMemoryAllocController

pub fn init( binding: ManagedMemoryBinding, resource: PinnedMemoryResource, ) -> Self

A controller over the pinned allocation binding names, resolved to resource.

Trait Implementations

impl AllocationController for PinnedMemoryAllocController

fn alloc_align(&self) -> usize

The alignment this allocation was created with.

fn property(&self) -> AllocationProperty

Returns memory property for the current allocation.

unsafe fn memory_mut( &mut self, _policy: AccessPolicy, ) -> Result<&mut [MaybeUninit<u8>], AccessError>

Returns a mutable view of the memory of the whole allocation, subject to policy.

fn memory( &self, _policy: AccessPolicy, ) -> Result<&[MaybeUninit<u8>], AccessError>

Returns a view of the memory of the whole allocation, subject to policy.

fn capacity(&self) -> usize

The total byte capacity of the allocation, WITHOUT materializing lazy storage.

fn split( &mut self, _offset: usize, ) -> Result<(Box<dyn AllocationController>, Box<dyn AllocationController>), SplitError>

Splits the current allocation in multiple separate allocations.

fn view( &self, _start: usize, _end: usize, ) -> Option<Box<dyn AllocationController>>

Returns a zero-copy controller over the sub-range [start, end) of this allocation when the backend supports cheap sub-views (files and shared buffers), borrowing &self. Returns None otherwise.

fn duplicate(&self) -> Option<Box<dyn AllocationController>>

Duplicates the current allocation with a clone on write strategy if the allocation controller supports it.

unsafe fn copy_into(&self, buf: &mut [u8])

Reads the data from the current allocation controller and copy its content into the provided buffer.

fn grow(&mut self, size: usize, align: usize) -> Result<(), AllocationError>

Extends the provided Allocation to a new size with specified alignment.

fn try_detach(&mut self) -> Option<NonNull<u8>>

Indicates whether the allocation uses the Rust alloc crate and can be safely managed by another data structure.