int SDL_GameControllerAddMapping(const char* mappingString)

Zwraca 1, jeśli została dodana nowa konfiguracja, 0, jeśli została uaktualniona istniejąca konfiguracja lub -1 przy błędzie; wywołaj funkcję SDL_GetError(), aby otrzymać więcej informacji na temat błędu.

Tekst z konfiguracją posiada format "GUID,nazwa,przydział", gdzie GUID jest tekstową wartością z SDL_JoystickGetGUIDString(), nazwa jest tekstem czytelnym dla człowieka opisującym dany kontroler gier, a przydział określa definicję kontrolera odwzorowaną na joysticki. W systemie Windows istnieje zarezerwowana nazwa GUID "xinput", która odnosi się do wszystkich urządzeń XInput. Format przydziału dla joysticka jest następujący:

bX	przycisk joysticka o indeksie X
hX.Y	grzybek X z wartością Y
aX	oś X joysticka

Przyciski mogą być używane jako osie kontrolera i na odwrót.

Ten tekst przedstawia przykładową definicję kontrolera gier:

"341a3608000000000000504944564944,Afterglow PS3 Controller,
a:b1,b:b2,y:b3,x:b0,start:b9,guide:b12,back:b8,dpup:h0.1,dpleft:h0.8,dpdown:h0.4,dpright:h0.2,leftshoulder:b4,rightshoulder:b5,leftstick:b10,rightstick:b11,leftx:a0,lefty:a1,rightx:a2,righty:a3,lefttrigger:b6,righttrigger:b7"

SDL_GameControllerMapping
SDL_GameControllerMappingForGUID