Enum gpu_alloc::MapError

pub enum MapError {
    OutOfDeviceMemory,
    OutOfHostMemory,
    NonHostVisible,
    MapFailed,
    AlreadyMapped,
}

Enumeration of possible errors that may occur during memory mapping.

Variants

OutOfDeviceMemory

Backend reported that device memory has been exhausted.
Deallocating device memory from the same heap may increase chance that another mapping would succeed.

OutOfHostMemory

Backend reported that host memory has been exhausted.
Deallocating host memory may increase chance that another mapping would succeed.

NonHostVisible

Attempt to map memory block with non-host-visible memory type.
Ensure to include UsageFlags::HOST_ACCESS into allocation request when memory mapping is intended.

MapFailed

Map failed for implementation specific reason.
For Vulkan backend this includes failed attempt to allocate large enough virtual address space.

AlreadyMapped

Mapping failed due to block being already mapped.

Trait Implementations

impl Clone for MapError

pub fn clone(&self) -> MapError

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for MapError

impl Debug for MapError

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

Formats the value using the given formatter.

impl Display for MapError

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

Formats the value using the given formatter.

impl Eq for MapError

impl Error for MapError

pub fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

pub fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

pub fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

pub fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<DeviceMapError> for MapError

pub fn from(err: DeviceMapError) -> Self

Performs the conversion.

impl From<OutOfMemory> for MapError

pub fn from(err: OutOfMemory) -> Self

Performs the conversion.

impl Hash for MapError

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl PartialEq<MapError> for MapError

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

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl StructuralEq for MapError

impl StructuralPartialEq for MapError