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の負荷を増やす原因になります。 なるべく行わないでください。