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

sdMidiSetDrctLev

MIDIポートのダイレクトレベルの設定

書式

SDE_ERR sdMidiSetDrctLev( handle, drct_lev )
SDMIDI handle
const Sint8 drct_lev

引数

handle   MIDIポートのハンドル
drct_lev   ダイレクトレベル

戻り値

SDE_ERR_NOTHING   エラーなし
SDE_ERR_NO_INIT   Sound Library が初期化されていない
SDE_ERR_HANDLE_NULL   ハンドルがNULL
SDE_ERR_PRM_OVER_RANGE   引数が正常な値の範囲外
SDE_ERR_HOST_CMD_BUF_NO_ENOUGH   ホストコマンドのバッファが不足

解説

指定したMIDIポートのダイレクトレベル(DSPによるFX処理を通らない音)を設定します。

Direct Levelを示す引数 drct_levの値の範囲は-007FH(最小)〜0000H(標準)〜007FH(最大)です。

引数drct_levは作成されたデータのダイレクトレベルを基準に相対値をとります。 つまりdrct_levの値を元に戻すとき(データに設定されたダイレクトレベルに戻すとき)は0を指定します。


備考

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

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