From dd6b484359e1c11652661f31a926c5d88af07feb Mon Sep 17 00:00:00 2001 From: Sam Lantinga 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 d0637cc070..6b8f3e561f 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_