Enum cpal::BuildStreamError

pub enum BuildStreamError {
    DeviceNotAvailable,
    StreamConfigNotSupported,
    InvalidArgument,
    StreamIdOverflow,
    BackendSpecific {
        err: BackendSpecificError,
    },
}

Error that can happen when creating a Stream.

Variants

DeviceNotAvailable

The device no longer exists. This can happen if the device is disconnected while the program is running.

StreamConfigNotSupported

The specified stream configuration is not supported.

InvalidArgument

We called something the C-Layer did not understand

On ALSA device functions called with a feature they do not support will yield this. E.g. Trying to use capture capabilities on an output only format yields this.

StreamIdOverflow

Occurs if adding a new Stream ID would cause an integer overflow.

BackendSpecific

See the BackendSpecificError docs for more information about this error variant.

Fields of BackendSpecific

err: BackendSpecificError

Trait Implementations

impl Debug for BuildStreamError

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

Formats the value using the given formatter.

impl Display for BuildStreamError

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

Formats the value using the given formatter.

impl Error for BuildStreamError

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

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

Returns a stack backtrace, if available, of where this error occurred.

fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<BackendSpecificError> for BuildStreamError

fn from(source: BackendSpecificError) -> Self

Performs the conversion.

impl From<Error> for BuildStreamError

fn from(err: Error) -> Self

Performs the conversion.