From dd6b484359e1c11652661f31a926c5d88af07feb Mon Sep 17 00:00:00 2001
From: Sam Lantinga <[EMAIL REDACTED]>
Date: Thu, 2 Jan 2025 11:16:35 -0800
Subject: [PATCH] Document platform gamepad hotplug requirements
Fixes https://github.com/libsdl-org/SDL/issues/11742
---
include/SDL3/SDL_gamepad.h | 2 ++
1 file changed, 2 insertions(+)
diff --git a/include/SDL3/SDL_gamepad.h b/include/SDL3/SDL_gamepad.h
index d0637cc070ba7..6b8f3e561f0f7 100644
--- a/include/SDL3/SDL_gamepad.h
+++ b/include/SDL3/SDL_gamepad.h
@@ -63,6 +63,8 @@
* By default SDL will try to use the most capable driver available, but you
* can tune which OS drivers to use with the various joystick hints in
* SDL_hints.h.
+ *
+ * Your application should always support gamepad hotplugging. On some platforms like Xbox, Steam Deck, etc., this is a requirement for certification. On other platforms, like macOS and Windows when using Windows.Gaming.Input, controllers may not be available at startup and will come in at some point after you've started processing events.
*/
#ifndef SDL_gamepad_h_