目次 - SDL 3.0 API(機能別) - 同期プリミティブ - SDL_CreateMutex

SDL_CreateMutex

ミューテックスをロックする

ヘッダ

SDL3/SDL_mutex.h

構文

void SDL_LockMutex(SDL_Mutex *mutex);

引数

SDL_Mutex *mutexロックするミューテックス

詳細

この関数はミューテックスが利用可能になるまで, つまりブロック解除か, OSが次にロックするスレッドとして選ばれるまでブロックする. ミューテックスのロックを待っている全てのスレッドの内, 一度にロックできるのは1つのみである.

ロック中のスレッドで再びロックすることは可能である. 他のスレッドで利用可能にするには, 同じ回数だけアンロックする必要がある(これは「再入可能ミューテックス」と呼ばれる).

この関数が失敗することはない. mutexがNULLの場合, 何もロックせずに即座に戻る. mutexが有効ならば, この関数は常にロック可能になるまでブロックし, ロックすると戻る.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_CreateMutex - SDL Wiki