int Mix_GroupChannels(int from, int to, int tag)
| from | タグ付けする最初のチャネル |
| to | タグ付けする最後のチャネル |
| tag | チャネルと関連付ける任意の値 |
タグは複数のミキサーチャネルと関連付けられる任意の値で, チャネルをグループ化できる.
'tag'が-1の場合, タグが取り除かれれる. (実際には-1は全チャネルをグループ化するタグとして使用されている.)
この関数はチャネルに既に設定されたタグを上書きするため, 1つのチャネルには1つのタグしか設定できない.
チャネルにMAX_CHANNEL_POSTを指定してはならない.
Mix_GroupChannel()とは異なり, この関数は失敗のとき負の数を戻す.