Sound Library - MIDIモジュールコントロール関数

sdMidiSetMuteCh

MIDI音源のChannel単位のMute(消音)

書式

SDE_ERR sdMidiSetMuteCh( handle, mask)
SDMIDI handle
const Uint16 mask

引数

handle   MIDIポートのハンドル
mask   マスクするMIDI Channel

戻り値

SDE_ERR_NOTHING   エラーなし
SDE_ERR_NO_INIT   Sound Library が初期化されていない

解説

指定されたMIDI portのMIDI Channelをマスク指定で Mute(消音)します。

マスクはbit0〜15がそれぞれMIDI Channel 0〜15に対応し、 各bitは1にするとそのMIDI Channelはマスクされ音が出なくなります。 例えばマスクをFF00HにするとMIDI Channel 8〜15がマスクされます。


備考

実際にはNote On(発音)とNote Off(発音停止)が処理されなくなるだけで MIDI Program Change(音色設定)やMIDI Control Change(パラメータ設定)などは行われます。

定期的なタイミングで行うアプリケーションで用意したサーバ関数などで、V同期で変化のない値を毎回設定し続けることは効率的なHost Command Bufferの利用方法でないばかりか、Sound Driverの負荷を増やす原因になります。 なるべく行わないでください。


sdMidiSetMuteCh
COPYRIGHT © SEGA ENTERPRISES, LTD., 1998-2000