SDE_ERR sdPstmSetFxInCh( handle, target_slot, fx_in_ch, base_fx_lev )
SDPSTM handle
const Sint8 target_slot
const Sint8 fx_in_ch
const Sint8 base_fx_lev
handle PCM Streamポートのハンドル target_slot スロット番号 fx_in_ch FX Input Channel番号 base_fx_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 ホストコマンドのバッファが不足
PCM StreamポートのFX Input Channelを設定します。指定できるFX Input Channelは00H〜0FHです。
引数target_slotには設定するスロット番号を指定します。 この引数にSDD_PSTM_PORT_SLOT_ALLを指定した場合は、指定したポートの全てのスロットに対して設定を行います。
ベースFX Input Levelを指定する引数 base_fx_levの指定範囲は0000H(最小)〜007FH(最大)です。
また、引数 fx_in_ch、base_fx_levは絶対値指定です。 引数base_fx_levとsdPstmSetFxLev()関数で指定する引数fx_levを演算し、最終FXレベルを決定します。
定期的なタイミングで行うアプリケーションで用意したサーバ関数などで、V同期で変化のない値を毎回設定し続けることは効率的なHost Command Bufferの利用方法でないばかりか、Sound Driverの負荷を増やす原因になります。 なるべく行わないでください。
sdPstmSetFxInLev() PCM StreamポートのFX Input Levelの設定