Struct gpu_alloc::MemoryBlock

source ·

pub struct MemoryBlock<M> {
    memory_type: u32,
    props: MemoryPropertyFlags,
    offset: u64,
    size: u64,
    atom_mask: u64,
    mapped: bool,
    flavor: MemoryBlockFlavor<M>,
    relevant: Relevant,
}

Expand description

Memory block allocated by GpuAllocator.

Fields§

§memory_type: u32§props: MemoryPropertyFlags§offset: u64§size: u64§atom_mask: u64§mapped: bool§flavor: MemoryBlockFlavor<M>§relevant: Relevant

Implementations§

source §

impl<M> MemoryBlock<M>

source

pub fn memory(&self) -> &M

Returns reference to parent memory object.

source

pub fn offset(&self) -> u64

Returns offset in bytes from start of memory object to start of this block.

source

pub fn size(&self) -> u64

Returns size of this memory block.

source

pub fn props(&self) -> MemoryPropertyFlags

Returns memory property flags for parent memory object.

source

pub fn memory_type(&self) -> u32

Returns index of type of parent memory object.

source

pub unsafe fn map( &mut self, device: &impl MemoryDevice<M>, offset: u64, size: usize, ) -> Result<NonNull<u8>, MapError>

Returns pointer to mapped memory range of this block. This blocks becomes mapped.

The user of returned pointer must guarantee that any previously submitted command that writes to this range has completed before the host reads from or writes to that range, and that any previously submitted command that reads from that range has completed before the host writes to that region. If the device memory was allocated without the HOST_COHERENT property flag set, these guarantees must be made for an extended range: the user must round down the start of the range to the nearest multiple of non_coherent_atom_size, and round the end of the range up to the nearest multiple of non_coherent_atom_size.

§Panics

This function panics if block is currently mapped.

§Safety

block must have been allocated from specified device.

source

pub unsafe fn unmap(&mut self, device: &impl MemoryDevice<M>) -> bool

Unmaps memory range of this block that was previously mapped with Block::map. This block becomes unmapped.

§Panics

This function panics if this block is not currently mapped.

§Safety

block must have been allocated from specified device.

source

pub unsafe fn write_bytes( &mut self, device: &impl MemoryDevice<M>, offset: u64, data: &[u8], ) -> Result<(), MapError>

Transiently maps block memory range and copies specified data to the mapped memory range.

§Panics

This function panics if block is currently mapped.

§Safety

block must have been allocated from specified device. The caller must guarantee that any previously submitted command that reads or writes to this range has completed.

source

pub unsafe fn read_bytes( &mut self, device: &impl MemoryDevice<M>, offset: u64, data: &mut [u8], ) -> Result<(), MapError>

Transiently maps block memory range and copies specified data from the mapped memory range.

§Panics

This function panics if block is currently mapped.

§Safety

block must have been allocated from specified device. The caller must guarantee that any previously submitted command that reads to this range has completed.

source