int Mix_ReserveChannels(int num)
再生関数でチャネルに-1を渡したときにサンプリング音声が再生されないようにチャネルをnum個予約する. チャネルは0番からnum-1番まで予約される. 0を渡すと全ての予約が解除される. 通常, SDL_mixerはチャネルを予約していない状態から始まる.
以下の関数がこの設定の影響を受ける:
Mix_PlayChannel
Mix_PlayChannelTimed
Mix_FadeInChannel
Mix_FadeInChannelTimed
戻り値: 予約されたチャネルの数を戻す. 失敗することはないが, 渡した数より少ないことがある. それは確保したチャネルの数による.
// 最初の8つのミキシングチャネルを予約する
int reserved_count;
reserved_count=Mix_ReserveChannels(8);
if(reserved_count!=8) {
printf("8つ予約できなかった!\n");
// これは致命的なエラーになりうる...
}
printf("%d つのチャネルを予約した\n",reserved_count);