Struct DmaPool

pub struct DmaPool { /* private fields */ }

A pool for allocating DMA regions that all share a common access type and DMA options.

Implementations

impl DmaPool

pub fn new(spec: CreateSpec, access: Access, opts: DmaOptions) -> Self

Create a new DmaPool with access and DMA options, where each created underlying Twizzler object is created using the provided CreateSpec. If default (volatile) options are acceptable for the create spec, use the crate::dma::DmaPool::default_spec function.

pub fn default_spec() -> CreateSpec

Generate a default CreateSpec for use in creating Twizzler DMA objects. By default, Twizzler objects for DMA are placed in volatile memory with a volatile lifetime.

pub fn allocate<'a, T: DeviceSync>( &'a self, init: T, ) -> Result<DmaRegion<T>, AllocationError>

Allocate a new DmaRegion from the pool. The region will be initialized with the provided initial value.

pub fn allocate_array<'a, T: DeviceSync + Clone>( &'a self, count: usize, init: T, ) -> Result<DmaSliceRegion<T>, AllocationError>

Allocate a new DmaSliceRegion from the pool. Each entry in the region’s slice will be initialized with the provided initial value.

pub fn allocate_array_with<'a, T: DeviceSync>( &'a self, count: usize, init: impl Fn() -> T, ) -> Result<DmaSliceRegion<T>, AllocationError>

Allocate a new DmaSliceRegion from the pool. Each entry in the region’s slice will be initialized by running the provided closure.