Struct StreamModeOverride 

pub struct StreamModeOverride { /* private fields */ }

Sets the mode of one client’s stream on its device while it lives, restored on drop: what a measurement opens, so its launches run whatever the process mode discards.

Keyed on the device and the stream the client’s launches go out on — a client bound to a stream of its own does not follow the thread’s — so it holds wherever those launches are issued from, a task resumed on another thread included. Overrides of one stream nest, the newest deciding, and may drop in any order.

Only the client’s stream follows it: a launch another client issues on another stream — a candidate holding a client bound elsewhere — keeps its own stream’s mode, and under a process mode that discards is discarded, so a measurement launches through the client it switched.

Every launch on that stream of that device follows it, whichever thread issues it. Where threads share a stream — StreamPolicy::Single, or a build without per-thread streams — a launch another thread issues while a measurement runs executes too, rather than being discarded.

Implementations

impl StreamModeOverride

pub fn new(mode: StreamMode, client: &Client) -> StreamModeOverride

Put client’s stream on its device in mode until the guard drops.

Trait Implementations

impl Debug for StreamModeOverride

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

Formats the value using the given formatter.

impl Drop for StreamModeOverride

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.