Struct DeviceHandle 

pub struct DeviceHandle {
    pub adapter: Adapter,
    pub device: Device,
    pub queue: Queue,
    pub caps: TierCaps,
    /* private fields */
}

A logical device, the adapter it was created from, the queue that executes its command buffers, and the capabilities that adapter reported.

Cheap to clone: wgpu’s Adapter/Device/Queue are all Arc-backed handles to one underlying object, so a clone is another handle to the same device rather than a second device. Clone it freely to hand a subsystem the device it needs instead of threading a &RenderContext borrow through it.

Fields

adapter: Adapter

The adapter the device was created from.

device: Device

The logical device.

queue: Queue

The queue that executes this device’s command buffers.

caps: TierCaps

What Self::adapter reported at device-creation time. Captured once so downstream pipeline/atlas decisions read plain data instead of re-probing the adapter.

Implementations

impl DeviceHandle

pub fn first_uncaptured_error(&self) -> Option<&str>

The first uncaptured wgpu error this device ever raised, or None if it has raised none.

Latched, never overwritten: a frame loop polling this wants the error that started the trouble, not the last one in a storm the first one caused. It is also the only programmatic view of an uncaptured error a caller gets — the handler otherwise only logs (see decide_log_action) — so a host can degrade or report instead of silently rendering nothing every frame.

Deliberately not clearable: “this device has seen an uncaptured error” is a property of the device, and a device that has raised one is not reliably recoverable by forgetting about it.

Trait Implementations

impl BufferUploader for DeviceHandle

type Buffer = Buffer

The created buffer — wgpu::Buffer in production.

fn allocate_buffer( &self, label: Option<&str>, size: u64, usage: BufferUsages, ) -> Buffer

Creates an uninitialized buffer of size bytes with usage.

fn write_buffer(&self, buffer: &Buffer, offset: u64, bytes: &[u8])

Copies bytes into buffer at offset.

impl Clone for DeviceHandle

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DeviceHandle

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

Formats the value using the given formatter.