目次 - 4.関数 - 4.4グループ - Mix_ReserveChannels

Mix_ReserveChannels

int Mix_ReserveChannels(int num)

num
予約するチャネルの数. 0のとき予約を解除する

再生関数でチャネルに-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);

参照

Mix_AllocateChannels

原文へのリンク

4.4.1 Mix_ReserveChannels