Check that Windows version is 11 or Server 2022 or later

Adds a check when creating a new uninitialisedsandbox to ensure that we are running on at least Windows 11 or Windows Server 2022

Signed-off-by: Simon Davies <[email protected]>

Author: simongdavies

README.md

@@ -174,8 +174,8 @@ the [./src/tests/rust_guests](./src/tests/rust_guests) directory for Rust guests
 You can run Hyperlight on:
 
 - [Linux with KVM][kvm].
-- [Windows with Windows Hypervisor Platform (WHP)][whp].
-- Windows Subsystem for Linux 2 ([WSL2][wsl2]) with KVM.
+- [Windows with Windows Hypervisor Platform (WHP).][whp] -  Note that you need Windows 11 or Windows Server 2022 to use hyperlight, if you are running on earlier versions of Windows then you should consider using our devcontainer on [GitHub codepsaces]((https://codespaces.new/hyperlight-dev/hyperlight)) or WSL2.
+- Windows Subsystem for Linux 2 (see instructions [here](https://learn.microsoft.com/en-us/windows/wsl/install) for Windows client and [here](https://learn.microsoft.com/en-us/windows/wsl/install-on-server) for Windows Server) with KVM.
 - Azure Linux with mshv (note that you need mshv to be installed to use Hyperlight)
 
 After having an environment with a hypervisor setup, running the example has the following pre-requisites:

src/hyperlight_host/src/sandbox/uninitialized.rs

@@ -142,6 +142,10 @@ impl UninitializedSandbox {
     ) -> Result<Self> {
         log_build_details();
 
+        // hyperlight is only supported on Windows 11 and Windows Server 2022 and later
+        #[cfg(target_os = "windows")]
+        check_windows_version()?;
+
         // If the guest binary is a file make sure it exists
         let guest_binary = match guest_binary {
             GuestBinary::FilePath(binary_path) => {
@@ -303,6 +307,31 @@ impl UninitializedSandbox {
         }
     }
 }
+// Check to see if the current version of Windows is supported
+// Hyperlight is only supported on Windows 11 and Windows Server 2022 and later
+#[cfg(target_os = "windows")]
+fn check_windows_version() -> Result<()> {
+    use windows_version::{is_server, OsVersion};
+    const WINDOWS_MAJOR: u32 = 10;
+    const WINDOWS_MINOR: u32 = 0;
+    const WINDOWS_PACK: u32 = 0;
+
+    // Windows Server 2022 has version numbers 10.0.20348 or greater
+    if is_server() {
+        if OsVersion::current() < OsVersion::new(WINDOWS_MAJOR, WINDOWS_MINOR, WINDOWS_PACK, 20348)
+        {
+            return Err(new_error!(
+                "Hyperlight Requires Windows Server 2022 or newer"
+            ));
+        }
+    } else {
+        if OsVersion::current() < OsVersion::new(WINDOWS_MAJOR, WINDOWS_MINOR, WINDOWS_PACK, 22000)
+        {
+            return Err(new_error!("Hyperlight Requires Windows 11 or newer"));
+        }
+    }
+    Ok(())
+}
 
 #[cfg(test)]
 mod tests {