Struct wgpu_core::device::resource::Device

pub struct Device<A: HalApi> { /* private fields */ }

Structure describing a logical device. Some members are internally mutable, stored behind mutexes.

TODO: establish clear order of locking for these: life_tracker, trackers, render_passes, pending_writes, trace.

Currently, the rules are:

1. life_tracker is locked after hub.devices, enforced by the type system
2. self.trackers is locked last (unenforced)
3. self.trace is locked last (unenforced)

Right now avoid locking twice same resource or registry in a call execution and minimize the locking to the minimum scope possibile Unless otherwise specified, no lock may be acquired while holding another lock. This means that you must inspect function calls made while a lock is held to see what locks the callee may try to acquire.

As far as this point: device_maintain_ids locks Device::lifetime_tracker, and calls… triage_suspected locks Device::trackers, and calls… Registry::unregister locks Registry::storage

Important: When locking pending_writes please check that trackers is not locked trackers should be locked only when needed for the shortest time possible

Implementations

impl<A: HalApi> Device<A>

pub fn is_valid(&self) -> bool

pub fn create_buffer_from_hal( self: &Arc<Self>, hal_buffer: A::Buffer, desc: &BufferDescriptor<'_> ) -> Buffer<A>

Trait Implementations

impl<A: HalApi> Debug for Device<A>

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

Formats the value using the given formatter.

impl<A: HalApi> Drop for Device<A>

fn drop(&mut self)

Executes the destructor for this type.

impl<A: HalApi> Resource<Id<Device<Api>>> for Device<A>

const TYPE: &'static str = "Device"

fn as_info(&self) -> &ResourceInfo<DeviceId>

fn as_info_mut(&mut self) -> &mut ResourceInfo<DeviceId>

fn label(&self) -> String

fn ref_count(self: &Arc<Self>) -> usize

fn is_unique(self: &Arc<Self>) -> bool

fn is_equal(&self, other: &Self) -> bool