From acbe86399d88cb46bdc83263d6e3bb716b887f09 Mon Sep 17 00:00:00 2001
From: "Ryan C. Gordon" <[EMAIL REDACTED]>
Date: Tue, 29 Jul 2025 23:21:47 -0400
Subject: [PATCH] docs: Note SDL_EVENT_AUDIO_DEVICE_ADDED is sent for all
devices at startup.
Fixes https://github.com/libsdl-org/sdlwiki/issues/721
---
include/SDL3/SDL_events.h | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/include/SDL3/SDL_events.h b/include/SDL3/SDL_events.h
index 353ecd3e5940e..60155b8103687 100644
--- a/include/SDL3/SDL_events.h
+++ b/include/SDL3/SDL_events.h
@@ -705,6 +705,10 @@ typedef struct SDL_GamepadSensorEvent
/**
* Audio device event structure (event.adevice.*)
*
+ * Note that SDL will send a SDL_EVENT_AUDIO_DEVICE_ADDED event for every
+ * device it discovers during initialization. After that, this event will only
+ * arrive when a device is hotplugged during the program's run.
+ *
* \since This struct is available since SDL 3.2.0.
*/
typedef struct SDL_AudioDeviceEvent