Enum CaptureError 

pub enum CaptureError {
    AccessDenied,
    AccessLost,
    RefreshFailure,
    Timeout,
    Fail(Error),
}

Available on Windows only.

Errors that can occur during screen capture operations.

Variants

AccessDenied

Access to the output duplication was denied.

This typically occurs when attempting to capture protected content, such as fullscreen video with DRM protection.

Recovery: Check if protected content is being displayed.

AccessLost

Access to the duplicated output was lost.

This occurs when the display configuration changes, such as:

• Switching between windowed and fullscreen mode
• Changing display resolution
• Connecting/disconnecting monitors
• Graphics driver updates

Recovery: Recreate the DXGIManager instance.

RefreshFailure

Failed to refresh the output duplication after a previous error.

Recovery: Recreate the DXGIManager instance or wait before retrying.

Timeout

The capture operation timed out.

This is a normal occurrence indicating that no new frame was available within the specified timeout period.

Recovery: This is not an error condition. Simply retry the capture.

Fail(Error)

A general or unexpected failure occurred.

Recovery: Log the error message and consider recreating the DXGIManager.

Trait Implementations

impl Debug for CaptureError

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

Formats the value using the given formatter.

impl Display for CaptureError

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

Formats the value using the given formatter.

impl Error for CaptureError

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 CaptureError

fn from(err: Error) -> Self

Converts to this type from the input type.