fix(audio-info): crash when device name contains special characters

Author: ReenigneArcher

cmake/compile_definitions/windows.cmake

@@ -59,6 +59,7 @@ set(PLATFORM_TARGET_FILES
         "${CMAKE_SOURCE_DIR}/src/platform/windows/display_ram.cpp"
         "${CMAKE_SOURCE_DIR}/src/platform/windows/display_wgc.cpp"
         "${CMAKE_SOURCE_DIR}/src/platform/windows/audio.cpp"
+        "${CMAKE_SOURCE_DIR}/src/platform/windows/tools/helper.h"
         "${CMAKE_SOURCE_DIR}/third-party/ViGEmClient/src/ViGEmClient.cpp"
         "${CMAKE_SOURCE_DIR}/third-party/ViGEmClient/include/ViGEm/Client.h"
         "${CMAKE_SOURCE_DIR}/third-party/ViGEmClient/include/ViGEm/Common.h"

src/platform/windows/input.cpp

@@ -5,7 +5,7 @@
 #define WINVER 0x0A00
 
 // platform includes
-#include <windows.h>
+#include <Windows.h>
 
 // standard includes
 #include <cmath>

src/platform/windows/misc.cpp

@@ -24,7 +24,7 @@
 #include <timeapi.h>
 #include <userenv.h>
 #include <winsock2.h>
-#include <windows.h>
+#include <Windows.h>
 #include <winuser.h>
 #include <wlanapi.h>
 #include <ws2tcpip.h>

src/platform/windows/misc.h

@@ -9,7 +9,7 @@
 #include <string_view>
 
 // platform includes
-#include <windows.h>
+#include <Windows.h>
 #include <winnt.h>
 
 namespace platf {

src/platform/windows/nvprefs/nvprefs_common.h

@@ -7,7 +7,7 @@
 // platform includes
 // disable clang-format header reordering
 // clang-format off
-#include <windows.h>
+#include <Windows.h>
 #include <aclapi.h>
 // clang-format on
 

src/platform/windows/publish.cpp

@@ -6,7 +6,7 @@
 // winsock2.h must be included before windows.h
 // clang-format off
 #include <winsock2.h>
-#include <windows.h>
+#include <Windows.h>
 // clang-format on
 #include <windns.h>
 #include <winerror.h>

src/platform/windows/tools/helper.h

@@ -0,0 +1,124 @@
+/**
+ * @file src/platform/windows/tools/helper.h
+ * @brief Helpers for tools.
+ */
+#pragma once
+
+// standard includes
+#include <iostream>
+#include <string>
+
+// lib includes
+#include <boost/locale.hpp>
+#include <boost/locale/conversion.hpp>
+
+// platform includes
+#include <Windows.h>
+
+/**
+ * @brief Safe console output utilities for Windows
+ * These functions prevent crashes when outputting strings with special characters.
+ * This is only used in tools/audio-info and tools/dxgi-info.
+ */
+namespace output {
+  /**
+   * @brief Return a non-null wide string, defaulting to "Unknown" if null
+   * @param str The wide string to check
+   * @return A non-null wide string
+   */
+  inline const wchar_t *no_null(const wchar_t *str) {
+    return str ? str : L"Unknown";
+  }
+
+  /**
+   * @brief Safely convert a wide string to console output using Windows API
+   * @param wstr The wide string to output
+   */
+  inline void safe_wcout(const std::wstring &wstr) {
+    if (wstr.empty()) {
+      return;
+    }
+
+    // Try to use the Windows console API for proper Unicode output
+    if (HANDLE hConsole = GetStdHandle(STD_OUTPUT_HANDLE); hConsole != INVALID_HANDLE_VALUE) {
+      DWORD written;
+      if (WriteConsoleW(hConsole, wstr.c_str(), static_cast<DWORD>(wstr.length()), &written, nullptr)) {
+        return;  // Success with WriteConsoleW
+      }
+    }
+
+    // Fallback: convert to narrow string and output to std::cout
+    try {
+      std::string narrow_str = boost::locale::conv::utf_to_utf<char>(wstr);
+      std::cout << narrow_str;
+    } catch (const boost::locale::conv::conversion_error &) {
+      // Final fallback: output character by character, replacing non-ASCII
+      for (wchar_t wc : wstr) {
+        if (wc >= 32 && wc < 127) {  // Printable ASCII
+          std::cout << static_cast<char>(wc);
+        } else {
+          std::cout << '?';
+        }
+      }
+    }
+  }
+
+  /**
+   * @brief Safely convert a wide string literal to console encoding and output it
+   * @param wstr The wide string literal to output
+   */
+  inline void safe_wcout(const wchar_t *wstr) {
+    if (wstr) {
+      safe_wcout(std::wstring(wstr));
+    } else {
+      std::cout << "Unknown";
+    }
+  }
+
+  /**
+   * @brief Safely convert a string to wide string and then to console output
+   * @param str The string to output
+   */
+  inline void safe_cout(const std::string &str) {
+    if (str.empty()) {
+      return;
+    }
+
+    try {
+      // Convert string to wide string first, then to console output
+      std::wstring wstr = boost::locale::conv::utf_to_utf<wchar_t>(str);
+      safe_wcout(wstr);
+    } catch (const boost::locale::conv::conversion_error &) {
+      // Fallback: output string directly, replacing problematic characters
+      for (char c : str) {
+        if (c >= 32 && c < 127) {  // Printable ASCII
+          std::cout << c;
+        } else {
+          std::cout << '?';
+        }
+      }
+    }
+  }
+
+  /**
+   * @brief Output a label and value pair safely
+   * @param label The label to output
+   * @param value The wide string value to output
+   */
+  inline void output_field(const std::string &label, const wchar_t *value) {
+    std::cout << label << " : ";
+    safe_wcout(value ? value : L"Unknown");
+    std::cout << std::endl;
+  }
+
+  /**
+   * @brief Output a label and string value pair
+   * @param label The label to output
+   * @param value The string value to output
+   */
+  inline void output_field(const std::string &label, const std::string &value) {
+    std::cout << label << " : ";
+    safe_cout(value);
+    std::cout << std::endl;
+  }
+}  // namespace output