From 35acd7a65b57a57c3e6624e19f16d73548111cfe Mon Sep 17 00:00:00 2001
From: David Reid <mackron@gmail.com>
Date: Tue, 6 Jan 2026 10:05:36 +1000
Subject: [PATCH] Relocate the sound end callback to after the sound is
 stopped.

Public issue https://github.com/mackron/miniaudio/issues/1013
---
 miniaudio.h | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/miniaudio.h b/miniaudio.h
index 2f9b3a51..51878fd7 100644
--- a/miniaudio.h
+++ b/miniaudio.h
@@ -76496,12 +76496,20 @@ static void ma_sound_set_at_end(ma_sound* pSound, ma_bool32 atEnd)
     MA_ASSERT(pSound != NULL);
     ma_atomic_exchange_32(&pSound->atEnd, atEnd);
 
+    /*
+    When this function is called the state of the sound will not yet be in a stopped state. This makes it confusing
+    because an end callback will intuitively expect ma_sound_is_started() to return false from inside the callback.
+    I'm therefore no longer firing the callback here and will instead fire it manually in the *next* processing step
+    when the state should be set to stopped as expected.
+    */
+    #if 0
     /* Fire any callbacks or events. */
     if (atEnd) {
         if (pSound->endCallback != NULL) {
             pSound->endCallback(pSound->pEndCallbackUserData, pSound);
         }
     }
+    #endif
 }
 
 static ma_bool32 ma_sound_get_at_end(const ma_sound* pSound)
@@ -76847,6 +76855,11 @@ static void ma_engine_node_process_pcm_frames__sound(ma_node* pNode, const float
     /* If we're marked at the end we need to stop the sound and do nothing. */
     if (ma_sound_at_end(pSound)) {
         ma_sound_stop(pSound);
+
+        if (pSound->endCallback != NULL) {
+            pSound->endCallback(pSound->pEndCallbackUserData, pSound);
+        }
+
         *pFrameCountOut = 0;
         return;
     }