From be4b0af971b179abcd00107aa6f3c018a462b8bc Mon Sep 17 00:00:00 2001
From: Jordan Woyak <jordan.woyak@gmail.com>
Date: Tue, 29 Apr 2025 20:33:39 -0500
Subject: [PATCH 1/2] Common: Add AsyncWorkThread.

---
 Source/Core/Common/WorkQueueThread.h | 38 ++++++++++++++++++++++++++--
 1 file changed, 36 insertions(+), 2 deletions(-)

diff --git a/Source/Core/Common/WorkQueueThread.h b/Source/Core/Common/WorkQueueThread.h
index 190afcabf2..9ad7c4f471 100644
--- a/Source/Core/Common/WorkQueueThread.h
+++ b/Source/Core/Common/WorkQueueThread.h
@@ -5,6 +5,7 @@
 
 #include <atomic>
 #include <functional>
+#include <future>
 #include <mutex>
 #include <string>
 #include <thread>
@@ -13,8 +14,6 @@
 #include "Common/SPSCQueue.h"
 #include "Common/Thread.h"
 
-// A thread that executes the given function for every item placed into its queue.
-
 namespace Common
 {
 namespace detail
@@ -158,6 +157,38 @@ private:
   using ProducerMutex = std::conditional_t<IsSingleProducer, DummyMutex, std::recursive_mutex>;
   ProducerMutex m_mutex;
 };
+
+// A WorkQueueThread-like class that takes functions to invoke.
+template <template <typename> typename WorkThread>
+class AsyncWorkThreadBase
+{
+public:
+  using FuncType = std::function<void()>;
+
+  AsyncWorkThreadBase() = default;
+  explicit AsyncWorkThreadBase(std::string thread_name) { Reset(std::move(thread_name)); }
+
+  void Reset(std::string thread_name)
+  {
+    m_worker.Reset(std::move(thread_name), std::invoke<FuncType>);
+  }
+
+  void Push(FuncType func) { m_worker.Push(std::move(func)); }
+
+  auto PushBlocking(FuncType func)
+  {
+    std::packaged_task task{std::move(func)};
+    m_worker.EmplaceItem([&] { task(); });
+    return task.get_future().get();
+  }
+
+  void Cancel() { m_worker.Cancel(); }
+  void Shutdown() { m_worker.Shutdown(); }
+  void WaitForCompletion() { m_worker.WaitForCompletion(); }
+
+private:
+  WorkThread<FuncType> m_worker;
+};
 }  // namespace detail
 
 // Multiple threads may use the public interface.
@@ -169,4 +200,7 @@ using WorkQueueThread = detail::WorkQueueThreadBase<T, false>;
 template <typename T>
 using WorkQueueThreadSP = detail::WorkQueueThreadBase<T, true>;
 
+using AsyncWorkThread = detail::AsyncWorkThreadBase<WorkQueueThread>;
+using AsyncWorkThreadSP = detail::AsyncWorkThreadBase<WorkQueueThreadSP>;
+
 }  // namespace Common

From 4e736d60db295c0700fa1391b473544a9cb5ed72 Mon Sep 17 00:00:00 2001
From: Jordan Woyak <jordan.woyak@gmail.com>
Date: Tue, 29 Apr 2025 20:21:08 -0500
Subject: [PATCH 2/2] Core and AudioCommon: Use AsyncWorkThread.

---
 Source/Core/AudioCommon/CubebStream.cpp          | 12 ++++++------
 Source/Core/AudioCommon/CubebStream.h            |  2 +-
 Source/Core/Core/AchievementManager.cpp          | 13 ++++++-------
 Source/Core/Core/AchievementManager.h            |  4 ++--
 Source/Core/Core/HW/EXI/EXI_DeviceMic.cpp        | 14 +++++++-------
 Source/Core/Core/HW/EXI/EXI_DeviceMic.h          |  2 +-
 Source/Core/Core/IOS/Network/KD/NetKDRequest.cpp |  7 +++----
 Source/Core/Core/IOS/Network/KD/NetKDRequest.h   |  2 +-
 8 files changed, 27 insertions(+), 29 deletions(-)

diff --git a/Source/Core/AudioCommon/CubebStream.cpp b/Source/Core/AudioCommon/CubebStream.cpp
index 92ab886580..4f97b9edd6 100644
--- a/Source/Core/AudioCommon/CubebStream.cpp
+++ b/Source/Core/AudioCommon/CubebStream.cpp
@@ -39,10 +39,10 @@ void CubebStream::StateCallback(cubeb_stream* stream, void* user_data, cubeb_sta
 
 CubebStream::CubebStream()
 #ifdef _WIN32
-    : m_work_queue("Cubeb Worker", [](const std::function<void()>& func) { func(); })
+    : m_work_queue("Cubeb Worker")
 {
   Common::Event sync_event;
-  m_work_queue.EmplaceItem([this, &sync_event] {
+  m_work_queue.Push([this, &sync_event] {
     Common::ScopeGuard sync_event_guard([&sync_event] { sync_event.Set(); });
     auto result = ::CoInitializeEx(nullptr, COINIT_MULTITHREADED | COINIT_DISABLE_OLE1DDE);
     m_coinit_success = result == S_OK;
@@ -62,7 +62,7 @@ bool CubebStream::Init()
   if (!m_coinit_success)
     return false;
   Common::Event sync_event;
-  m_work_queue.EmplaceItem([this, &return_value, &sync_event] {
+  m_work_queue.Push([this, &return_value, &sync_event] {
     Common::ScopeGuard sync_event_guard([&sync_event] { sync_event.Set(); });
 #endif
 
@@ -113,7 +113,7 @@ bool CubebStream::SetRunning(bool running)
   if (!m_coinit_success)
     return false;
   Common::Event sync_event;
-  m_work_queue.EmplaceItem([this, running, &return_value, &sync_event] {
+  m_work_queue.Push([this, running, &return_value, &sync_event] {
     Common::ScopeGuard sync_event_guard([&sync_event] { sync_event.Set(); });
 #endif
     if (running)
@@ -132,7 +132,7 @@ CubebStream::~CubebStream()
 {
 #ifdef _WIN32
   Common::Event sync_event;
-  m_work_queue.EmplaceItem([this, &sync_event] {
+  m_work_queue.Push([this, &sync_event] {
     Common::ScopeGuard sync_event_guard([&sync_event] { sync_event.Set(); });
 #endif
     cubeb_stream_stop(m_stream);
@@ -156,7 +156,7 @@ void CubebStream::SetVolume(int volume)
   if (!m_coinit_success)
     return;
   Common::Event sync_event;
-  m_work_queue.EmplaceItem([this, volume, &sync_event] {
+  m_work_queue.Push([this, volume, &sync_event] {
     Common::ScopeGuard sync_event_guard([&sync_event] { sync_event.Set(); });
 #endif
     cubeb_stream_set_volume(m_stream, volume / 100.0f);
diff --git a/Source/Core/AudioCommon/CubebStream.h b/Source/Core/AudioCommon/CubebStream.h
index 72d7d1c117..a523d65441 100644
--- a/Source/Core/AudioCommon/CubebStream.h
+++ b/Source/Core/AudioCommon/CubebStream.h
@@ -39,7 +39,7 @@ private:
   std::vector<float> m_floatstereo_buffer;
 
 #ifdef _WIN32
-  Common::WorkQueueThread<std::function<void()>> m_work_queue;
+  Common::AsyncWorkThread m_work_queue;
   bool m_coinit_success = false;
   bool m_should_couninit = false;
 #endif
diff --git a/Source/Core/Core/AchievementManager.cpp b/Source/Core/Core/AchievementManager.cpp
index 2ebe12b672..bc9bc7ec07 100644
--- a/Source/Core/Core/AchievementManager.cpp
+++ b/Source/Core/Core/AchievementManager.cpp
@@ -78,9 +78,8 @@ void AchievementManager::Init(void* hwnd)
                              });
     m_config_changed_callback_id = Config::AddConfigChangedCallback([this] { SetHardcoreMode(); });
     SetHardcoreMode();
-    m_queue.Reset("AchievementManagerQueue", [](const std::function<void()>& func) { func(); });
-    m_image_queue.Reset("AchievementManagerImageQueue",
-                        [](const std::function<void()>& func) { func(); });
+    m_queue.Reset("AchievementManagerQueue");
+    m_image_queue.Reset("AchievementManagerImageQueue");
 
 #ifdef RC_CLIENT_SUPPORTS_RAINTEGRATION
     // Attempt to load the integration DLL from the directory containing the main client executable.
@@ -1258,7 +1257,7 @@ void AchievementManager::Request(const rc_api_request_t* request,
 {
   std::string url = request->url;
   std::string post_data = request->post_data;
-  AchievementManager::GetInstance().m_queue.EmplaceItem(
+  AchievementManager::GetInstance().m_queue.Push(
       [url = std::move(url), post_data = std::move(post_data), callback = std::move(callback),
        callback_data = std::move(callback_data)] {
         Common::HttpRequest http_request;
@@ -1354,7 +1353,7 @@ u32 AchievementManager::MemoryPeeker(u32 address, u8* buffer, u32 num_bytes, rc_
 
 void AchievementManager::FetchBadge(AchievementManager::Badge* badge, u32 badge_type,
                                     const AchievementManager::BadgeNameFunction function,
-                                    const UpdatedItems callback_data)
+                                    UpdatedItems callback_data)
 {
   if (!m_client || !HasAPIToken())
   {
@@ -1364,8 +1363,8 @@ void AchievementManager::FetchBadge(AchievementManager::Badge* badge, u32 badge_
     return;
   }
 
-  m_image_queue.EmplaceItem([this, badge, badge_type, function = std::move(function),
-                             callback_data = std::move(callback_data)] {
+  m_image_queue.Push([this, badge, badge_type, function = std::move(function),
+                      callback_data = std::move(callback_data)] {
     Common::ScopeGuard on_end_scope([&]() {
       if (m_display_welcome_message && badge_type == RC_IMAGE_TYPE_GAME)
         DisplayWelcomeMessage();
diff --git a/Source/Core/Core/AchievementManager.h b/Source/Core/Core/AchievementManager.h
index 012800c1b7..c75bbbb384 100644
--- a/Source/Core/Core/AchievementManager.h
+++ b/Source/Core/Core/AchievementManager.h
@@ -299,8 +299,8 @@ private:
   std::string m_title_estimate;
 #endif  // RC_CLIENT_SUPPORTS_RAINTEGRATION
 
-  Common::WorkQueueThread<std::function<void()>> m_queue;
-  Common::WorkQueueThread<std::function<void()>> m_image_queue;
+  Common::AsyncWorkThread m_queue;
+  Common::AsyncWorkThread m_image_queue;
   mutable std::recursive_mutex m_lock;
   std::recursive_mutex m_filereader_lock;
 };  // class AchievementManager
diff --git a/Source/Core/Core/HW/EXI/EXI_DeviceMic.cpp b/Source/Core/Core/HW/EXI/EXI_DeviceMic.cpp
index 410462cd4e..995376486e 100644
--- a/Source/Core/Core/HW/EXI/EXI_DeviceMic.cpp
+++ b/Source/Core/Core/HW/EXI/EXI_DeviceMic.cpp
@@ -37,7 +37,7 @@ void CEXIMic::StreamInit()
   if (!m_coinit_success)
     return;
   Common::Event sync_event;
-  m_work_queue.EmplaceItem([this, &sync_event] {
+  m_work_queue.Push([this, &sync_event] {
     Common::ScopeGuard sync_event_guard([&sync_event] { sync_event.Set(); });
 #endif
     m_cubeb_ctx = CubebUtils::GetContext();
@@ -57,7 +57,7 @@ void CEXIMic::StreamTerminate()
     if (!m_coinit_success)
       return;
     Common::Event sync_event;
-    m_work_queue.EmplaceItem([this, &sync_event] {
+    m_work_queue.Push([this, &sync_event] {
       Common::ScopeGuard sync_event_guard([&sync_event] { sync_event.Set(); });
 #endif
       m_cubeb_ctx.reset();
@@ -105,7 +105,7 @@ void CEXIMic::StreamStart()
   if (!m_coinit_success)
     return;
   Common::Event sync_event;
-  m_work_queue.EmplaceItem([this, &sync_event] {
+  m_work_queue.Push([this, &sync_event] {
     Common::ScopeGuard sync_event_guard([&sync_event] { sync_event.Set(); });
 #endif
     // Open stream with current parameters
@@ -152,7 +152,7 @@ void CEXIMic::StreamStop()
   {
 #ifdef _WIN32
     Common::Event sync_event;
-    m_work_queue.EmplaceItem([this, &sync_event] {
+    m_work_queue.Push([this, &sync_event] {
       Common::ScopeGuard sync_event_guard([&sync_event] { sync_event.Set(); });
 #endif
       if (cubeb_stream_stop(m_cubeb_stream) != CUBEB_OK)
@@ -200,7 +200,7 @@ CEXIMic::CEXIMic(Core::System& system, int index)
     : IEXIDevice(system), slot(index)
 #ifdef _WIN32
       ,
-      m_work_queue("Mic Worker", [](const std::function<void()>& func) { func(); })
+      m_work_queue("Mic Worker")
 #endif
 {
   m_position = 0;
@@ -218,7 +218,7 @@ CEXIMic::CEXIMic(Core::System& system, int index)
 
 #ifdef _WIN32
   Common::Event sync_event;
-  m_work_queue.EmplaceItem([this, &sync_event] {
+  m_work_queue.Push([this, &sync_event] {
     Common::ScopeGuard sync_event_guard([&sync_event] { sync_event.Set(); });
     auto result = ::CoInitializeEx(nullptr, COINIT_MULTITHREADED | COINIT_DISABLE_OLE1DDE);
     m_coinit_success = result == S_OK;
@@ -238,7 +238,7 @@ CEXIMic::~CEXIMic()
   if (m_should_couninit)
   {
     Common::Event sync_event;
-    m_work_queue.EmplaceItem([this, &sync_event] {
+    m_work_queue.Push([this, &sync_event] {
       Common::ScopeGuard sync_event_guard([&sync_event] { sync_event.Set(); });
       m_should_couninit = false;
       CoUninitialize();
diff --git a/Source/Core/Core/HW/EXI/EXI_DeviceMic.h b/Source/Core/Core/HW/EXI/EXI_DeviceMic.h
index 3641fabe21..4836c80583 100644
--- a/Source/Core/Core/HW/EXI/EXI_DeviceMic.h
+++ b/Source/Core/Core/HW/EXI/EXI_DeviceMic.h
@@ -102,7 +102,7 @@ private:
   int samples_avail;
 
 #ifdef _WIN32
-  Common::WorkQueueThread<std::function<void()>> m_work_queue;
+  Common::AsyncWorkThread m_work_queue;
   bool m_coinit_success = false;
   bool m_should_couninit = false;
 #endif
diff --git a/Source/Core/Core/IOS/Network/KD/NetKDRequest.cpp b/Source/Core/Core/IOS/Network/KD/NetKDRequest.cpp
index 1c60649102..af22bd610f 100644
--- a/Source/Core/Core/IOS/Network/KD/NetKDRequest.cpp
+++ b/Source/Core/Core/IOS/Network/KD/NetKDRequest.cpp
@@ -169,8 +169,7 @@ NetKDRequestDevice::NetKDRequestDevice(EmulationKernel& ios, const std::string&
   });
 
   m_handle_mail = !ios.GetIOSC().IsUsingDefaultId() && !m_send_list.IsDisabled();
-  m_scheduler_work_queue.Reset("WiiConnect24 Scheduler Worker",
-                               [](std::function<void()> task) { task(); });
+  m_scheduler_work_queue.Reset("WiiConnect24 Scheduler Worker");
 
   m_scheduler_timer_thread = std::thread([this] { SchedulerTimer(); });
 }
@@ -218,7 +217,7 @@ void NetKDRequestDevice::SchedulerTimer()
       std::lock_guard lg(m_scheduler_lock);
       if (m_mail_span <= mail_time_state && m_handle_mail)
       {
-        m_scheduler_work_queue.EmplaceItem([this] { SchedulerWorker(SchedulerEvent::Mail); });
+        m_scheduler_work_queue.Push([this] { SchedulerWorker(SchedulerEvent::Mail); });
         INFO_LOG_FMT(IOS_WC24, "NET_KD_REQ: Dispatching Mail Task from Scheduler");
         mail_time_state = 0;
       }
@@ -226,7 +225,7 @@ void NetKDRequestDevice::SchedulerTimer()
       if (m_download_span <= download_time_state && !m_dl_list.IsDisabled())
       {
         INFO_LOG_FMT(IOS_WC24, "NET_KD_REQ: Dispatching Download Task from Scheduler");
-        m_scheduler_work_queue.EmplaceItem([this] { SchedulerWorker(SchedulerEvent::Download); });
+        m_scheduler_work_queue.Push([this] { SchedulerWorker(SchedulerEvent::Download); });
         download_time_state = 0;
       }
     }
diff --git a/Source/Core/Core/IOS/Network/KD/NetKDRequest.h b/Source/Core/Core/IOS/Network/KD/NetKDRequest.h
index 7158b22648..9ae50fa81f 100644
--- a/Source/Core/Core/IOS/Network/KD/NetKDRequest.h
+++ b/Source/Core/Core/IOS/Network/KD/NetKDRequest.h
@@ -111,7 +111,7 @@ private:
   NWC24::Mail::WC24SendList m_send_list;
   NWC24::Mail::WC24FriendList m_friend_list;
   Common::WorkQueueThreadSP<AsyncTask> m_work_queue;
-  Common::WorkQueueThreadSP<std::function<void()>> m_scheduler_work_queue;
+  Common::AsyncWorkThreadSP m_scheduler_work_queue;
   std::mutex m_async_reply_lock;
   std::mutex m_scheduler_buffer_lock;
   std::queue<AsyncReply> m_async_replies;