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


Halt playing of a group of channels by arbitrary tag.

Header File

Defined in <SDL_mixer.h>


int Mix_HaltGroup(int tag);

Function Parameters

int tag an arbitrary value, assigned to channels, to search for.

Return Value

(int) Returns zero, whether any channels were halted or not.


This will stop further playback on all channels with a specific tag, until a new chunk is started there.

A tag is an arbitrary number that can be assigned to several mixer channels, to form groups of channels.

The default tag for a channel is -1.

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


This function is available since SDL_mixer 2.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.