目次 - SDL 3.0 API(機能別) - 非同期I/O - SDL_GetAsyncIOResult

SDL_GetAsyncIOResult

キューの非同期I/Oタスクの完了状態をチェックする

ヘッダ

SDL3/SDL_asyncio.h

構文

bool SDL_GetAsyncIOResult(SDL_AsyncIOQueue *queue, SDL_AsyncIOOutcome *outcome);

引数

SDL_AsyncIOQueue *queueチェックするSDL_AsyncIOキュー
SDL_AsyncIOOutcome *outcomeタスクの完了結果の代入先へのポインタ. NULL不可

戻り値

(bool) タスクが完了したとき真, それ以外のとき偽を戻す.

詳細

キューのタスクが完了すると, この関数は真を戻し, outcomeにタスクの詳細が設定される. 完了したタスクがない場合, この関数は偽を戻す. この関数はブロックしない.

タスクが完了すると, この関数はタスクの資源を解放しタスクへのポインタは無効になり, タスクはキューから取り除かれる.

同一のキューに対して複数のスレッドからこの関数を呼ぶことは安全である. 完了したタスクは1つのスレッドのみに伝えられる.

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_GetAsyncIOResult - SDL Wiki