SDL Wiki
(This function is part of SDL_mixer, a separate library from SDL.)


Set a callback that runs when a channel has finished playing.

Header File

Defined in SDL_mixer.h


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

Function Parameters

channel_finished the callback function to become the new notification mechanism.


The callback may be called from the mixer's audio callback or it could be called as a result of Mix_HaltChannel(), etc.

The callback has a single parameter, channel, which says what mixer channel has just stopped.

Do not call SDL_LockAudio() from this callback; you will either be inside the audio callback, or SDL_mixer will explicitly lock the audio before calling your callback.

A NULL pointer will disable the callback.


This function is available since SDL_mixer 3.0.0.

CategoryAPI, CategoryAPIFunction

[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.