Struct vulkano::memory::DeviceMemory

pub struct DeviceMemory { /* private fields */ }

Represents memory that has been allocated from the device.

The destructor of DeviceMemory automatically frees the memory.

Example

use vulkano::memory::{DeviceMemory, MemoryAllocateInfo};

let memory_type_index = 0;

// Allocates 1KB of memory.
let memory = DeviceMemory::allocate(
    device.clone(),
    MemoryAllocateInfo {
        allocation_size: 1024,
        memory_type_index,
        ..Default::default()
    },
).unwrap();

Implementations

impl DeviceMemory

pub fn allocate(
    device: Arc<Device>,
    allocate_info: MemoryAllocateInfo<'_>
) -> Result<Self, DeviceMemoryError>

Allocates a block of memory from the device.

Some platforms may have a limit on the maximum size of a single allocation. For example, certain systems may fail to create allocations with a size greater than or equal to 4GB.

Panics

• Panics if allocate_info.allocation_size is 0.
• Panics if allocate_info.dedicated_allocation is Some and the contained buffer or image does not belong to device.

pub unsafe fn import(
    device: Arc<Device>,
    allocate_info: MemoryAllocateInfo<'_>,
    import_info: MemoryImportInfo
) -> Result<Self, DeviceMemoryError>

Imports a block of memory from an external source.

Safety

• See the documentation of the variants of MemoryImportInfo.

Panics

• Panics if allocate_info.allocation_size is 0.
• Panics if allocate_info.dedicated_allocation is Some and the contained buffer or image does not belong to device.

pub fn memory_type_index(&self) -> u32

Returns the index of the memory type that this memory was allocated from.

pub fn allocation_size(&self) -> DeviceSize

Returns the size in bytes of the memory allocation.

pub fn commitment(&self) -> Result<DeviceSize, DeviceMemoryError>

Retrieves the amount of lazily-allocated memory that is currently commited to this memory object.

The device may change this value at any time, and the returned value may be already out-of-date.

self must have been allocated from a memory type that has the lazily_allocated flag set.

pub fn export_fd(
    &self,
    handle_type: ExternalMemoryHandleType
) -> Result<File, DeviceMemoryError>

Exports the device memory into a Unix file descriptor. The caller owns the returned File.

Panic

• Panics if the user requests an invalid handle type for this device memory object.

Trait Implementations

impl AsMut<DeviceMemory> for MappedDeviceMemory

fn as_mut(&mut self) -> &mut DeviceMemory

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<DeviceMemory> for MappedDeviceMemory

fn as_ref(&self) -> &DeviceMemory

Converts this type into a shared reference of the (usually inferred) input type.

impl Debug for DeviceMemory

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl DeviceOwned for DeviceMemory

fn device(&self) -> &Arc<Device>

Returns the device that owns Self.

impl Drop for DeviceMemory

fn drop(&mut self)

Executes the destructor for this type.

impl Hash for DeviceMemory

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where
    H: Hasher,

Feeds a slice of this type into the given Hasher.

impl PartialEq<DeviceMemory> for DeviceMemory

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl VulkanObject for DeviceMemory

type Object = DeviceMemory

The type of the object.

fn internal_object(&self) -> DeviceMemory

Returns a reference to the object.

impl Eq for DeviceMemory