uefi: Add safe bindings for HiiConfigRouting protocol

Author: seijikun

uefi/CHANGELOG.md

@@ -10,6 +10,7 @@
 - Added `proto::acpi::AcpiTable`.
 - Added `proto::hii::database::HiiDatabase`.
 - Added `proto::hii::config_str::MultiConfigurationStringIter`.
+- Added `proto::hii::config_routing::HiiConfigRouting`.
 
 ## Changed
 - **Breaking:** `boot::stall` now take `core::time::Duration` instead of `usize`.

uefi/src/proto/hii/config_routing.rs

@@ -0,0 +1,38 @@
+// SPDX-License-Identifier: MIT OR Apache-2.0
+
+//! HII Configuration protocols.
+
+use core::ptr;
+
+use alloc::string::{String, ToString};
+use uefi_macros::unsafe_protocol;
+use uefi_raw::Char16;
+use uefi_raw::protocol::hii::config::HiiConfigRoutingProtocol;
+
+use crate::{CStr16, StatusExt};
+
+/// The HII Configuration Routing Protocol.
+///
+/// # UEFI Spec Description
+///
+/// The EFI HII Configuration Routing Protocol manages the movement of configuration
+/// data from drivers to configuration applications. It then serves as the single point
+/// to receive configuration information from configuration applications, routing the results
+/// to the appropriate drivers.
+#[derive(Debug)]
+#[repr(transparent)]
+#[unsafe_protocol(HiiConfigRoutingProtocol::GUID)]
+pub struct HiiConfigRouting(HiiConfigRoutingProtocol);
+impl HiiConfigRouting {
+    /// Request the current configuration for the entirety of the current HII database and
+    /// return the data as string in multi configuration string format.
+    ///
+    /// Use `super::config_str::MultiConfigurationStringIter` to parse the returned `String`.
+    pub fn export(&self) -> uefi::Result<String> {
+        unsafe {
+            let mut results: *const Char16 = ptr::null();
+            (self.0.export_config)(&self.0, &mut results)
+                .to_result_with_val(|| CStr16::from_ptr(results.cast()).to_string())
+        }
+    }
+}

uefi/src/proto/hii/mod.rs

@@ -4,6 +4,8 @@
 
 pub mod config;
 #[cfg(feature = "alloc")]
+pub mod config_routing;
+#[cfg(feature = "alloc")]
 pub mod config_str;
 #[cfg(feature = "alloc")]
 pub mod database;