wdi 0.1.5

Rust library for interacting with the Windows Driver Installer subsystem.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

// SPDX-License-Identifier: MIT OR Apache-2.0
// SPDX-FileCopyrightText: 2022-2023 1BitSquared <info@1bitsquared.com>
// SPDX-FileContributor: Written by Mikaela Szekely <mikaela.szekely@qyriad.me>
use std::fmt;
use std::fmt::Display;

#[derive(Debug, Copy, Clone, PartialEq)]
#[non_exhaustive]
pub enum Error
{
    InvalidParam,
    Access,
    Resource,
    NotFound,
    NoDevice,
    Busy,
}

impl Error
{
    /// Create an [Error] from a libwdi error code (e.g. [libwdi_sys::WDI_ERROR_NO_DEVICE].
    ///
    /// If there is not a corresponding error for the passed value, this function returns None.
    pub fn from_error_code(code: i32) -> Option<Self>
    {
        use libwdi_sys::*;
        use Error::*;

        match code {
            WDI_ERROR_INVALID_PARAM => Some(InvalidParam),
            WDI_ERROR_ACCESS => Some(Access),
            WDI_ERROR_RESOURCE => Some(Resource),
            WDI_ERROR_NO_DEVICE => Some(NoDevice),
            WDI_ERROR_NOT_FOUND => Some(NotFound),
            WDI_ERROR_BUSY => Some(Busy),
            _ => None,
        }
    }
}

impl Display for Error
{
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result
    {
        use Error::*;

        match self {
            InvalidParam => write!(f, "Invalid parameter")?,
            Access => write!(f, "Access denied (insufficient permissions)")?,
            NoDevice => write!(f, "No such device (it may have been disconnected)")?,
            NotFound => write!(f, "Entity not found")?,
            Busy => write!(f, "Resource busy, or API call already running")?,
            Resource => write!(f, "Could not acquire resource (insufficient memory, etc)")?,
        };

        Ok(())
    }
}

impl std::error::Error for Error { }