mixReserveChannels function

int mixReserveChannels(int num)

Reserve the first channels for the application.

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.

\param num number of channels to reserve, starting at index zero. \returns the number of reserved channels.

\since This function is available since SDL_mixer 3.0.0.

extern SDL_DECLSPEC int SDLCALL Mix_ReserveChannels(int num)

Implementation

int mixReserveChannels(int num) {
  final mixReserveChannelsLookupFunction = libSdl3Mixer.lookupFunction<
      Int32 Function(Int32 num), int Function(int num)>('Mix_ReserveChannels');
  return mixReserveChannelsLookupFunction(num);
}