目次 - 4.関数 - 4.3チャネル - Mix_ChannelFinished

Mix_ChannelFinished

チャネルの再生が完了したとき呼ばれるコールバックを設定する

構文

void Mix_ChannelFinished(void (SDLCALL *channel_finished)(int channel))

引数

channel_finished新しい完了通知手段となるコールバック関数

サンプルコード

// チャネル終了関数を作る
void channelDone(int channel)
{
    printf("チャネル %d は再生を終了した\n", channel);
}
...
// チャネルでの再生が終了したとき呼ばれるコールバック関数を設定する
Mix_ChannelFinished(channelDone);

詳細

コールバックはミキサーのオーディオコールバックやMix_HaltChannel()を呼ぶなどの場合に呼ばれる.

コールバック関数は1つの引数, 停止したチャネル番号を持つ.

このコールバック関数の内部でSDL_LockAudio()を呼んではならない. SDL_mixerはあなたのコールバックを呼ぶ前に明確にオーディオをロックしている.

NULLポインタを設定するとコールバックが無効になる.

バージョン

SDL_mixer 2.0.0以降

原文へのリンク

SDL_mixer/Mix_ChannelFinished