int Mix_ReserveChannels(int num)
num
- Number of channels to reserve from default mixing. Zero removes all reservations.
Reserve num channels from being used when playing samples when passing in -1 as a channel number to playback functions. The channels are reserved starting from channel 0 to num-1. Passing in zero will unreserve all channels. Normally SDL_mixer starts without any channels reserved.
The following functions are affected by this setting: 4.3.3 Mix_PlayChannel 4.3.4 Mix_PlayChannelTimed 4.3.5 Mix_FadeInChannel 4.3.6 Mix_FadeInChannelTimed
Returns: The number of channels reserved. Never fails, but may return less channels than you ask for, depending on the number of channels previously allocated.
// reserve the first 8 mixing channels int reserved_count; reserved_count=Mix_ReserveChannels(8); if(reserved_count!=8) {
- printf("reserved %d channels from default mixing.\n",reserved_count); printf("8 channels were not reserved!\n"); // this might be a critical error...
}
See Also: 4.3.1 Mix_AllocateChannels