docs/README-winrt.md
changeset 11502 f778543ed8dd
parent 11446 d1c34d85b47c
child 11503 084b3caa1bc8
     1.1 --- a/docs/README-winrt.md	Fri Sep 15 17:27:32 2017 -0700
     1.2 +++ b/docs/README-winrt.md	Tue Sep 19 10:31:22 2017 -0400
     1.3 @@ -75,7 +75,10 @@
     1.4      anything outside of the app is not supported.
     1.5    * system path retrieval via SDL's filesystem APIs
     1.6    * game controllers.  Support is provided via the SDL_Joystick and
     1.7 -    SDL_GameController APIs, and is backed by Microsoft's XInput API.
     1.8 +    SDL_GameController APIs, and is backed by Microsoft's XInput API.  Please
     1.9 +    note, however, that Windows limits game-controller support in UWP apps to,
    1.10 +    "Xbox compatible controllers" (many controllers that work in Win32 apps,
    1.11 +    do not work in UWP, due to restrictions in UWP itself.) 
    1.12    * multi-touch input
    1.13    * app events.  SDL_APP_WILLENTER* and SDL_APP_DIDENTER* events get sent out as
    1.14      appropriate.
    1.15 @@ -103,8 +106,10 @@
    1.16      SDL_CreateSystemCursor() (unsupported on Windows Phone)
    1.17    * SDL_WarpMouseInWindow() or SDL_WarpMouseGlobal().  This are not currently
    1.18      supported by WinRT itself.
    1.19 -  * joysticks and game controllers that aren't supported by Microsoft's XInput
    1.20 -    API.
    1.21 +  * joysticks and game controllers that either are not supported by
    1.22 +    Microsoft's XInput API, or are not supported within UWP apps (many
    1.23 +    controllers that work in Win32, do not work in UWP, due to restrictions in
    1.24 +    UWP itself).
    1.25    * turning off VSync when rendering on Windows Phone.  Attempts to turn VSync
    1.26      off on Windows Phone result either in Direct3D not drawing anything, or it
    1.27      forcing VSync back on.  As such, SDL_RENDERER_PRESENTVSYNC will always get
    1.28 @@ -520,3 +525,16 @@
    1.29  Once you install these components, try re-launching Visual Studio, and re-opening
    1.30  the SDL project file.  If you still get the error dialog, try using the Output
    1.31  window, again, seeing what Visual Studio says about it.
    1.32 +
    1.33 +#### Game controllers / joysticks aren't working!
    1.34 +
    1.35 +Windows only permits certain game controllers and joysticks to work within
    1.36 +WinRT / UWP apps.  Even if a game controller or joystick works in a Win32
    1.37 +app, that device is not guaranteed to work inside a WinRT / UWP app.
    1.38 +
    1.39 +According to Microsoft, "Xbox compatible controllers" should work inside
    1.40 +UWP apps, potentially with more working in the future.  This includes, but
    1.41 +may not be limited to, Microsoft-made Xbox controllers and USB adapters.
    1.42 +(Source: https://social.msdn.microsoft.com/Forums/en-US/9064838b-e8c3-4c18-8a83-19bf0dfe150d/xinput-fails-to-detect-game-controllers?forum=wpdevelop)
    1.43 +
    1.44 +