NAME¶

Mix_ReserveChannels - Reserve the first channels for the application.

SYNOPSIS¶

#include "SDL3_mixer/SDL_mixer.h"

int Mix_ReserveChannels(int num);

DESCRIPTION¶

While SDL_mixer will use up to the number of channels allocated by

Mix_AllocateChannels (), this sets channels aside that will not be available when calling Mix_PlayChannel

with a channel of -1 (play on the first unused channel). In this case, SDL_mixer will treat reserved channels as "used" whether anything is playing on them at the moment or not.

This is useful if you've budgeted some channels for dedicated audio and the rest are just used as they are available.

Calling this function will set channels 0 to n-1 to be reserved. This will not change channel allocations. The number of reserved channels will be clamped to the current number allocated.

By default, no channels are reserved.

FUNCTION PARAMETERS¶

num

number of channels to reserve, starting at index zero.

RETURN VALUE¶

Returns the number of reserved channels.

AVAILABILITY¶

This function is available since SDL_mixer 3.0.0.