Struct MapContext 

pub(crate) struct MapContext {
    mapped: Option<MappingInfo>,
    sub_ranges: Vec<Subrange>,
    device_buffers: Arc<Mutex<HashSet<WeakMapContext>>>,
}

The mapped portion of a buffer, if any, and its outstanding views.

This ensures that views fall within the mapped range and don’t overlap.

Fields

mapped: Option<MappingInfo>

This becomes Some(…) when the buffer is mapped at creation time, and when you call map_async on some BufferSlice (so technically, it indicates the data that is or has been requested to be mapped.)

sub_ranges: Vec<Subrange>

The ranges covered by all outstanding BufferViews and BufferViewMuts. These are non-overlapping, and are all contained within mapped_range.

device_buffers: Arc<Mutex<HashSet<WeakMapContext>>>

The set of buffers that are currently alive on the device. This is used to ensure that all buffers are unmapped before the device is destroyed.

We keep it here

Implementations

impl MapContext

pub(crate) fn new( mapped: Option<MappingInfo>, device_buffers: &Arc<Mutex<HashSet<WeakMapContext>>>, ) -> Arc<Mutex<Self>>

Creates a new MapContext.

For mapped_at_creation buffers, pass the full buffer range in the mapped_range argument. For other buffers, pass None.

fn reset(&mut self)

Record that the buffer is no longer mapped.

fn validate_and_add(&mut self, new_sub: Subrange) -> Result<(), MapRangeError>

Record that the size bytes of the buffer at offset are now viewed.

Errors

This returns an error if the given range is invalid.

pub(crate) fn remove(&mut self, offset: BufferAddress, size: BufferAddress)

Record that the size bytes of the buffer at offset are no longer viewed.

Panics

This panics if the given range does not exactly match one previously passed to MapContext::validate_and_add.

Trait Implementations

impl Debug for MapContext

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

Formats the value using the given formatter.

impl Drop for MapContext

fn drop(&mut self)

Executes the destructor for this type.