void Mix_HookMusicFinished(void (SDLCALL *music_finished)(void))
| music_finished | 停止を処理する新しいコールバック関数 |
このコールバックは, 現在の音楽再生が完了したとき, またはMix_HaltMusic()を呼んで停止したとき呼ばれる. コールバックは不特定のバックグラウンドスレッドからいつでも呼ばれる可能性があり, ここで行えることには限りがある.
このコールバックで新しい音楽オブジェクトの再生を開始する(または停止した音楽を再び再生する)のは正しい処理で, 再生が正常に完了した音楽を間を空けることなくループさせるために使用できる.
このコールバックでSDL_LockAudio()を呼んではならない. オーディオコールバックの中にあるか, SDL_mixerがコールバックを呼ぶ前にオーディオをロックしている.
NULLポインタの場合, コールバックは無効になる.