Enum DeviceLostReason

#[repr(u8)]
pub enum DeviceLostReason {
    Unknown = 0,
    Destroyed = 1,
    Dropped = 2,
    ReplacedCallback = 3,
    DeviceInvalid = 4,
}

Reason for “lose the device”.

Corresponds to WebGPU GPUDeviceLostReason.

Variants

Unknown = 0

Triggered by driver

Destroyed = 1

After Device::destroy

Dropped = 2

After Device::drop

WebGPU does not invoke the device lost callback when the device is dropped to prevent garbage collection from being observable. In wgpu, we invoke the callback on drop to help with managing memory owned by the callback.

ReplacedCallback = 3

After replacing the device_lost_callback

WebGPU does not have a concept of a device lost callback, but wgpu does. wgpu guarantees that any supplied callback will be invoked exactly once before it is dropped, which helps with managing the memory owned by the callback.

DeviceInvalid = 4

When setting the callback, but the device is already invalid

As above, when the callback is provided, wgpu guarantees that it will eventually be called. If the device is already invalid, wgpu will call the callback immediately, with this reason.

Trait Implementations

impl Clone for DeviceLostReason

fn clone(&self) -> DeviceLostReason

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DeviceLostReason

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

Formats the value using the given formatter.

impl PartialEq for DeviceLostReason

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Copy for DeviceLostReason

impl Eq for DeviceLostReason

impl StructuralPartialEq for DeviceLostReason