bool SDL_LoadFileAsync(const char *file, SDL_AsyncIOQueue *queue, void *userdata);
| const char * | file | オープンするファイルの名前のUTF-8文字列 |
| SDL_AsyncIOQueue * | queue | 新しいSDL_AsyncIOの追加先キュー |
| void * | userdata | 処理結果に渡されるアプリケーション定義のポインタ |
この関数は読み込みの完了を待たず, 可能な限り早く戻る. 成功して戻ったとき, 処理は背後で行われている. 処理が始まった後は失敗も非同期である. この関数が失敗の値を戻すのは処理を開始できなかった場合のみである.
データの末尾には便利のためNUL文字が追加される.
これはSDL_AsyncIOOutcomeのbytes_transferredの値には含まれない.
この関数はファイルの内容のバッファを確保する.
SDL_AsyncIOOutcomeのbufferは不要になったときSDL_free()で解放する必要がある.
SDL_AsyncIOQueueは必ず指定しなければならない. クローズ処理が完了したとき, 新しいタスクが生成されここに追加される.