Enum Error 

pub enum Error {
    Ffmpeg(Error),
    NoCodec(u32),
    BackendUnsupportedByCodec(Backend),
    HwDeviceInitFailed(HwDeviceInitFailed),
    AllBackendsFailed(AllBackendsFailed),
    FallbackFailed(FallbackFailed),
}

Errors returned from crate::VideoDecoder.

Debug is derived; the variants that wrap a payload struct (HwDeviceInitFailed, AllBackendsFailed, FallbackFailed) delegate their Debug to the payload, which is hand-written where needed because ffmpeg_next::Packet (carried by AllBackendsFailed::unconsumed_packets / FallbackFailed::unconsumed_packets) does not derive Debug. Those payloads summarize the packet count rather than dumping each packet’s fields, which would be both noisy and useless for triage.

Variants

Ffmpeg(Error)

An underlying FFmpeg error.

NoCodec(u32)

avcodec_find_decoder returned null for the input codec id. The id is reported as the raw integer (AVCodecID discriminant) — we do not construct the bindgen AVCodecID enum from a runtime value, since values outside our build’s discriminant set would invoke UB.

BackendUnsupportedByCodec(Backend)

The codec does not advertise a hardware configuration matching the requested backend (via avcodec_get_hw_config).

HwDeviceInitFailed(HwDeviceInitFailed)

av_hwdevice_ctx_create failed for the requested backend. See [HwDeviceInitFailed] for the payload details. #[from] gives a free impl From<HwDeviceInitFailed> for Error, so inner helpers that return Result<_, HwDeviceInitFailed> can be ?-propagated into Error directly.

AllBackendsFailed(AllBackendsFailed)

Auto-probe exhausted every backend in the platform’s order. See [AllBackendsFailed] for the payload details (in particular the unconsumed_packets history that callers should replay through their own software decoder for non-seekable inputs). #[from] gives a free impl From<AllBackendsFailed> for Error.

FallbackFailed(FallbackFailed)

Surfaced by crate::FfmpegVideoStreamDecoder when a HW->SW fallback attempt itself fails. See [FallbackFailed] for the payload details (in particular the rescued unconsumed_packets the HW path had already consumed from the caller). #[from] gives a free impl From<FallbackFailed> for Error.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

Returns the lower-level source of this error, if any.

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

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl From<Error> for AudioDecodeError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SubtitleDecodeError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for VideoDecodeError

fn from(source: Error) -> Self

Converts to this type from the input type.