Struct Captures 

pub struct Captures<D: GraphDriver> { /* private fields */ }

The graphs this device has instantiated, keyed by the GraphId handed to the client.

Referencing a graph by id is what keeps the executable inside the server: nothing across the actor boundary ever holds one.

Implementations

impl<D: GraphDriver> Captures<D>

pub fn insert(&mut self, id: GraphId, graph: Graph<D>)

Register a freshly instantiated graph under the id its capture was given.

pub fn contains(&self, id: GraphId) -> bool

Whether id still names a live graph.

pub fn extend_written(&self, id: GraphId, written: &mut Vec<BufferBinding>)

Add the buffers id’s recorded launches write to written.

Extends rather than answers with a vector of its own, because the caller is filling a pooled write set and a replay should allocate for it no more than a launch does.

An unknown id adds nothing, which is the honest answer rather than a missing one: a graph that is gone took the record of which buffers went with it, and a replay of it writes nothing.

pub fn replay( &self, id: GraphId, stream: &mut D::Stream, ) -> Result<(), ServerError>

Enqueue id’s recorded sequence on stream.

The stream’s existing errors are ignored — they surface on the next sync — so a replay only ever adds its own.

Errors

ServerError::Generic when id names no live graph, which the caller hands straight back: nothing was enqueued and nothing is stale.

pub fn destroy(&mut self, id: GraphId, stream: &mut D::Stream)

Drop the executable id names and release what it held: the buffers it pinned go with it, and the info-cache entries no other live graph still pins are freed. A no-op for an unknown id, so a double release is one.

The caller syncs stream first — a replay enqueued against this executable may still be running.

Trait Implementations

impl<D: GraphDriver> Debug for Captures<D>

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

Formats the value using the given formatter.

impl<D: GraphDriver> Default for Captures<D>

fn default() -> Self

Returns the “default value” for a type.