Struct DeviceCatalog 

pub struct DeviceCatalog { /* private fields */ }

Registry of stream-device providers.

Implementations

impl DeviceCatalog

pub fn new() -> Self

Builds an empty device catalog.

pub fn default_modeled() -> Self

Builds a catalog with deterministic modeled MIDI and audio providers.

pub fn with_registry_audio_devices(registry: &Registry) -> Self

Builds a modeled catalog plus audio sites exported by loaded libs.

pub fn register(&mut self, provider: Box<dyn DeviceProvider>)

Registers a device provider.

pub fn register_provider_sites(&mut self, router: &AudioRouter)

Adds a snapshot of the audio sites currently registered by a provider.

pub fn register_registry_audio_devices(&mut self, registry: &Registry)

Adds audio-site records currently owned by loaded registry libs.

pub fn enumerate(&self) -> Result<Vec<DeviceRecord>>

Enumerates every registered provider.

pub fn open_checked( &self, cx: &mut Cx, id: &Symbol, ) -> Result<Box<dyn StreamEvalSite>>

Opens a cataloged stream evaluation site by device id after checking authority and recording the declared device effects.

pub fn open(&self, id: &Symbol) -> Result<Box<dyn StreamEvalSite>>

Opens a cataloged stream evaluation site by device id through the provider-level compatibility dispatch path.

Runtime and public host opens should use Self::open_checked so the catalog row’s authority and device effects are handled first.

pub fn open_live_checked( &self, cx: &mut Cx, id: &Symbol, ) -> Result<MidiLiveEvalSite>

Opens a cataloged MIDI device as a live MIDI evaluation site after checking authority and recording the declared device effects.

pub fn open_live(&self, id: &Symbol) -> Result<MidiLiveEvalSite>

Opens a cataloged MIDI device as a live MIDI evaluation site through the compatibility dispatch path.

Runtime and public host opens should use Self::open_live_checked so the catalog row’s authority and device effects are handled first.

pub fn enumerate_midi(&self) -> Result<Vec<DeviceRecord>>

Enumerates MIDI device rows.

pub fn enumerate_audio(&self) -> Result<Vec<DeviceRecord>>

Enumerates audio device rows.

pub fn audio_backend_names(&self) -> Result<Vec<String>>

Returns safe audio backend candidate names from catalog records.

Hardware records contribute their transport name. Modeled records keep the deterministic modeled fallback as the final candidate.

pub fn midi_backend_names(&self) -> Result<Vec<String>>

Returns safe MIDI backend candidate names from catalog records.

Hardware records contribute their transport name. Modeled records keep the deterministic modeled fallback as the final candidate.

pub fn audio_hardware_backend_names(&self) -> Result<Vec<String>>

Returns audio backend candidate names for real hardware only.

pub fn midi_hardware_backend_names(&self) -> Result<Vec<String>>

Returns MIDI backend candidate names for real hardware only.

Trait Implementations

impl Default for DeviceCatalog

fn default() -> Self

Returns the “default value” for a type.