Struct MediaReceiverReservation 

pub struct MediaReceiverReservation { /* private fields */ }

Provisional ownership of a stream’s single-consumer inbound receiver.

Dropping an uncommitted reservation restores the receiver to its stream. This lets an orchestrator reserve every source needed by a multi-leg media operation before transferring any one source into a graph. Committing is the explicit point at which rollback is disabled and the caller becomes the receiver’s permanent owner.

Implementations

impl MediaReceiverReservation

pub fn new( receiver: Receiver<MediaFrame>, restore: impl FnOnce(Receiver<MediaFrame>) + Send + 'static, ) -> MediaReceiverReservation

Create a rollback-capable receiver reservation.

pub fn with_commit_hook( self, on_commit: impl FnOnce() + Send + 'static, ) -> MediaReceiverReservation

Install a hook that runs only when provisional ownership is committed.

This is primarily useful for ownership accounting. A rolled-back reservation must not be counted as a destructive receiver acquisition.

pub fn commit(self) -> Receiver<MediaFrame>

Transfer permanent ownership of the reserved receiver to the caller.

Trait Implementations

impl Drop for MediaReceiverReservation

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.