int SDL_AddGamepadMappingsFromIO(SDL_IOStream *src, bool closeio);
| SDL_IOStream * | src | 追加するマッピングのデータストリーム |
| bool | closeio | 真のとき戻る前にSDL_CloseIO()を呼ぶ(エラーの場合でも) |
(int) 成功のとき追加したマッピングの数, 失敗のとき負の数を戻す. SDL_GetError()を呼んで詳細を知ることができる.
異なる複数のデータベースファイルを読み込むために, この関数を複数回呼ぶことができる.
既に追加済みのGUIDのマッピングを読み込んだ場合, 新しい方で上書きされる.
このGUIDのデバイスが既に接続されているとき, SDLはSDL_EVENT_GAMEPAD_ADDEDイベントを発生させる.
現在の環境に属していない, または環境が特定されないマッピングは無視される. (例えば, LinuxはWindowsの設定を無視する, など)
この関数は処理する前にテキストのデータベースを読み込む. メモリの少ない環境ではこのことに注意する必要がある.
この関数はどのスレッドからも安全に呼べる.