Enum gpu_alloc::AllocationError

pub enum AllocationError {
    OutOfDeviceMemory,
    OutOfHostMemory,
    NoCompatibleMemoryTypes,
    TooManyObjects,
}

Enumeration of possible errors that may occur during memory allocation.

Variants

OutOfDeviceMemory

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

OutOfHostMemory

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

NoCompatibleMemoryTypes

Allocation request cannot be fulfilled as no available memory types allowed by Request.memory_types mask is compatible with request.usage.

TooManyObjects

Reached limit on allocated memory objects count.
Deallocating device memory may increase chance that another allocation would succeed. Especially dedicated memory blocks.

If this error is returned when memory heaps are far from exhausted Config should be tweaked to allocate larger memory objects.

Trait Implementations

impl Clone for AllocationError

fn clone(&self) -> AllocationError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for AllocationError

impl Debug for AllocationError

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

Formats the value using the given formatter.

impl Display for AllocationError

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

Formats the value using the given formatter.

impl Eq for AllocationError

impl Error for AllocationError

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<OutOfMemory> for AllocationError

fn from(err: OutOfMemory) -> Self

Performs the conversion.

impl Hash for AllocationError

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<AllocationError> for AllocationError

fn eq(&self, other: &AllocationError) -> 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 AllocationError

impl StructuralPartialEq for AllocationError