##### Sound Library - One Shotモジュールコントロール関数

# sdShotSetReleaseMode

One ShotポートのOne Shot Dataの再生停止時のリリースの設定

### 書式

> `SDE_ERR sdShotSetReleaseMode( handle, release_mode)
> SDSHOT handle
> SDE_PORT_RELEASE_MODE release_mode
> `

### 引数

> handle | One Shotポートのハンドル
> release_mode | 設定するリリースモード

### 戻り値

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

### 解説

> sdStopStop()関数を使用してOne Shot Dataの再生停止を行う時発音中の音のリリース(余韻)を有効にするかどうかを指定します。

> 次の値を設定することができます。

> 定義 | 意味
> SDE_PORT_RELEASE_MODE_ENABLE | リリースを有効にする
> SDE_PORT_RELEASE_MODE_DISABLE | リリースを無効にする

### 備考

> One Shotポートを用いて曲・SEを再生し、停止してからサウンドメモリの内容を書き換える時(例えばMulti Unit Fileのダウンロードなど)音色のリリースが有効になっていると再生中の音色内容をダウンロードにて書き換えてしまい、ノイズになってしまう可能性があります。

> このような場合、sdMidiSetRelaseMode()関数を利用していったんOne Shot Dataの再生停止時のリリースを無効にしておくと、ノイズが発生しなくなります。

### 参照

> sdShotStop() | One Shot再生の停止

sdShotSetReleaseMode

COPYRIGHT © SEGA ENTERPRISES, LTD., 1998-2000