int SDL_AddGamepadMappingsFromFile(const char *file);
| const char * | file | 読み込むマッピングファイル |
(int) 成功のとき追加したマッピングの数, 失敗のとき負の数を戻す. SDL_GetError()を呼んで詳細を知ることができる.
異なる複数のデータベースファイルを読み込むために, この関数を複数回呼ぶことができる.
既に追加済みのGUIDのマッピングを読み込んだ場合, 新しい方で上書きされる.
このGUIDのデバイスが既に接続されているとき, SDLはSDL_EVENT_GAMEPAD_ADDEDイベントを発生させる.
現在の環境に属していない, または環境が特定されないマッピングは無視される. (例えば, LinuxはWindowsの設定を無視する, など)
この関数はどのスレッドからも安全に呼べる.