[][src]Struct vulkano::memory::MappedDeviceMemory

pub struct MappedDeviceMemory { /* fields omitted */ }

Represents memory that has been allocated and mapped in CPU accessible space.

Can be obtained with DeviceMemory::alloc_and_map. The function will panic if the memory type is not host-accessible.

In order to access the content of the allocated memory, you can use the read_write method. This method returns a guard object that derefs to the content.


use vulkano::memory::DeviceMemory;

// The memory type must be mappable.
let mem_ty = device.physical_device().memory_types()
                    .filter(|t| t.is_host_visible())
                    .next().unwrap();    // Vk specs guarantee that this can't fail

// Allocates 1KB of memory.
let memory = DeviceMemory::alloc_and_map(device.clone(), mem_ty, 1024).unwrap();

// Get access to the content. Note that this is very unsafe for two reasons: 1) the content is
// uninitialized, and 2) the access is unsynchronized.
unsafe {
    let mut content = memory.read_write::<[u8]>(0 .. 1024);
    content[12] = 54;       // `content` derefs to a `&[u8]` or a `&mut [u8]`


impl MappedDeviceMemory[src]

pub fn unmap(self) -> DeviceMemory[src]

Unmaps the memory. It will no longer be accessible from the CPU.

pub unsafe fn read_write<T: ?Sized>(&self, range: Range<usize>) -> CpuAccess<T> where
    T: Content

Gives access to the content of the memory.

This function takes care of calling vkInvalidateMappedMemoryRanges and vkFlushMappedMemoryRanges on the given range. You are therefore encouraged to use the smallest range as possible, and to not call this function multiple times in a row for several small changes.


  • Type safety is not checked. You must ensure that T corresponds to the content of the buffer.
  • Accesses are not synchronized. Synchronization must be handled outside of the MappedDeviceMemory.

Trait Implementations

impl DeviceOwned for MappedDeviceMemory[src]

impl Send for MappedDeviceMemory[src]

impl Sync for MappedDeviceMemory[src]

impl AsRef<DeviceMemory> for MappedDeviceMemory[src]

impl AsMut<DeviceMemory> for MappedDeviceMemory[src]

impl Debug for MappedDeviceMemory[src]

Auto Trait Implementations

Blanket Implementations

impl<T> DeviceOwned for T where
    T: Deref,
    <T as Deref>::Target: DeviceOwned

impl<T> Content for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 

impl<T> From<T> for T[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<T> Borrow<T> for T where
    T: ?Sized

impl<T> BorrowMut<T> for T where
    T: ?Sized

impl<T> Any for T where
    T: 'static + ?Sized