Struct HostedGraphNode

pub struct HostedGraphNode<H: HostHandlers> { /* private fields */ }

Expand description

Send prepared native audio node for graph-owned explicit audio sessions. Main prepare validates the already activated fixed contract. Audio start, process/reset/stop run on the guarded owner; deactivation returns its stopped token through one prepared slot, without executing native main callbacks. One-shot: reactivation requires a fresh activation/node after reclaim, not graph reprepare. Recover the inactive instance through control.into_instance(). Node-owned audio scratch is <=32 MiB, outside graph’s own 64 MiB cap; plugin memory/time are separate. Main instance control must outlive this token.

Implementations§

§

impl<H: HostHandlers> HostedGraphNode<H>

pub fn set_transport_enabled( &mut self, enabled: bool, ) -> Result<(), PrepareError>

Explicit main-thread transport opt-in while stopped. Disabled by default; require known playing for any context and reject invalid/ unrepresentable fields before native calls. Discontinuity has no native flag and does not reset history; see hosted_transport.

Trait Implementations§

§

impl<H: HostHandlers> Processor for HostedGraphNode<H>

§

fn try_reset(&mut self) -> Result<(), ProcessError>

Forwards the inner checked reset; never masks a refusal.

§

fn prepare(&mut self, config: ProcessConfig) -> Result<(), PrepareError>

§

fn start_audio(&mut self) -> Result<(), ProcessError>

Optional explicit audio-owner session start, after prepare and before rendering. Default is a no-op. Consumers using these hooks call once on the audio owner and stop there before transfer/deactivation. Failure must leave this processor stopped; earlier successful nodes may be stopped. Hooks follow prepared callback allocation/locking/I/O obligations. Existing adapters do not implicitly opt in; explicit graph sessions supply them.

§

fn stop_audio(&mut self)

End an explicitly started session on its audio owner, without deactivation or storage destruction. Default no-op; preparation/history may be retained.

§