Struct BufferBinding 

pub struct BufferBinding {
    pub memory: ManagedMemoryBinding,
    pub service: ServiceId,
    pub offset_start: Option<u64>,
    pub offset_end: Option<u64>,
    pub stream: StreamId,
    pub size: u64,
}

A buffer binding represents a Handle that is bound to managed memory.

The memory used is known by the compute server. A buffer binding is only valid after being initlized with [super::Server::initialize_bindings]

Notes

A buffer binding is detached from a Handle, meaning that is won’t affect Handle::can_mut.

Fields

memory: ManagedMemoryBinding

The id of the handle the binding is bound to.

service: ServiceId

The service whose memory this binding addresses; see Handle::service.

offset_start: Option<u64>

Memory offset in bytes.

offset_end: Option<u64>

Memory offset in bytes.

stream: StreamId

The stream where the data was created.

size: u64

Length of the underlying buffer ignoring offsets

Implementations

impl BufferBinding

pub fn size_in_used(&self) -> u64

Get the size of the handle, in bytes, accounting for offsets

pub fn range(&self) -> Range<u64>

The byte range of the allocation this binding names: what the offsets leave of the buffer. This is the region the taint bookkeeping claims when work writing through this binding fails, and releases when work writing through it lands.

pub fn claim_key(&self) -> (ManagedMemoryId, u64, u64)

The identity a claim on this binding is stored under: the allocation and the byte range of it, exactly as range computes it.

Anything that deduplicates or compares claims — a capture’s write set, above all — must key by this and nothing coarser. Two tensors carved from one batched allocation share a memory id and nothing else; keyed by the id alone, one sibling’s claim swallows the others’.

pub fn size(&self) -> u64

Get the total size of the handle, in bytes.

Trait Implementations

impl Clone for BufferBinding

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 BufferBinding

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

Formats the value using the given formatter.