Enum Error 

pub enum Error {
    Unsupported(&'static str),
    OutOfMemory {
        what: &'static str,
    },
    LimitExceeded {
        what: &'static str,
        requested: u64,
        limit: u64,
    },
    ExternalImport(String),
    DeviceLost,
    Timeout {
        what: &'static str,
    },
    Backend {
        backend: &'static str,
        detail: String,
    },
}

Variants

Unsupported(&'static str)

The backend or driver does not support the requested operation.

Callers are expected to have checked crate::Capabilities first; receiving this is a bug in the caller, not a condition to branch on at the call site.

OutOfMemory

Device memory or host memory exhausted.

Fields

what: &'static str

LimitExceeded

A requested resource exceeded a reported device limit.

Fields

what: &'static str

requested: u64

limit: u64

ExternalImport(String)

A dma-buf could not be imported, usually a format or modifier the importing device does not accept.

DeviceLost

The device was lost. Everything created from it is invalid.

Timeout

A wait exceeded its timeout without what it waited for happening.

what names it, because a frame loop has more than one thing it can be stuck on – a fence that never signals, a flip that never lands, a slot that never comes free – and they have different causes. A single message for all of them means reading the code and reasoning about which timeout could have elapsed in the time the run took, which is what this error made necessary once.

Fields

what: &'static str

Backend

Backend-specific failure that has no portable representation.

Fields

backend: &'static str

detail: String

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

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

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.