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


Halt playing of a particular channel.

Header File

Defined in <SDL3_mixer/SDL_mixer.h>


int Mix_HaltChannel(int channel);

Function Parameters

int channel channel to halt, or -1 to halt all channels.

Return Value

(int) Returns 0 on success, or -1 on error.


This will stop further playback on that channel until a new chunk is started there.

Specifying a channel of -1 will halt all channels, except for any playing music.

Any halted channels will have any currently-registered effects deregistered, and will call any callback specified by Mix_ChannelFinished() before this function returns.

You may not specify MAX_CHANNEL_POST for a channel.


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.