iohidmanager 0.6.0

Safe Rust bindings for Apple's IOKit HID — enumerate, inspect, and subscribe to HID devices on macOS
Documentation
#[allow(clippy::wildcard_imports)]
use super::*;
use crate::{bridge, ffi_impl as ffi};

impl HidValue {
    /// Create a value that references the provided byte slice without asking
    /// the bridge to duplicate it first.
    ///
    /// # Safety
    ///
    /// `bytes` must remain valid and unchanged for at least as long as the
    /// returned `HidValue` may read from its backing storage.
    ///
    /// # Errors
    ///
    /// Returns `HidError::InvalidArgument` when the slice length does not fit
    /// `CFIndex`, or `HidError::OperationFailed` when `CoreHID` rejects the
    /// value creation request.
    pub unsafe fn from_bytes_no_copy(
        element: HidElement,
        timestamp: u64,
        bytes: &[u8],
    ) -> Result<Self, HidError> {
        let length = ffi::CFIndex::try_from(bytes.len()).map_err(|_| {
            HidError::InvalidArgument("byte slice length does not fit CFIndex".to_owned())
        })?;
        let raw = unsafe {
            bridge::iohidmanager_swift_value_create_with_bytes_no_copy(
                element.raw.cast(),
                timestamp,
                if bytes.is_empty() { core::ptr::null() } else { bytes.as_ptr() },
                length,
            )
        };
        if raw.is_null() {
            Err(HidError::OperationFailed(
                "IOHIDValueCreateWithBytesNoCopy",
            ))
        } else {
            Ok(Self { raw: raw.cast() })
        }
    }
}