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 = device.physical_device().memory_types().next().unwrap();

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

Implementations

impl DeviceMemory

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

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, DeviceMemoryAllocationError>

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(&self) -> MemoryType<'_>

Returns 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 export_fd(
    &self,
    handle_type: ExternalMemoryHandleType
) -> Result<File, DeviceMemoryExportError>

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

Performs the conversion.

impl AsRef<DeviceMemory> for MappedDeviceMemory

fn as_ref(&self) -> &DeviceMemory

Performs the conversion.

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 !=.

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