サウンド関数 - データユーティリティ関数

sdBankDownload

各種サウンドデータのダウンロード

書式

SDE_ERR sdBankDownload( handle, bank_type, bank_num )
SDMEMBLK handle
SDE_DATA_TYPE bank_type
Sint32 bank_num

引数

handleダウンロードするバンクのブロック情報のハンドル
bank_typeダウンロードするバンク種類
bank_numダウンロード先のバンク番号

戻値

SDE_ERR_NO_INITサウンドライブラリを初期化していない
SDE_ERR_HANDLE_NULLハンドルがNULLだった
SDE_ERR_HANDLE_ILLEGAL_VALUEハンドルがおかしなアドレスを指している
SDE_ERR_DATA_ILLEGAL_TYPEデータタイプが異常

解説

メインメモリ上にある各種バンクをサウンドメモリへダウンロードします。

バンクの種類を指定する引数 bank_type には次の指定が可能です。

SDE_DATA_TYPE_SND_DRVサウンドドライバ
SDE_DATA_TYPE_MULTI_UNITマルチユニット
SDE_DATA_TYPE_MIDI_SEQ_DATAMIDIシーケンスデータ
SDE_DATA_TYPE_MIDI_SEQ_BANKMIDIシーケンスバンク-MIDIシーケンスデータの集まり
SDE_DATA_TYPE_MIDI_PRG_BANKMIDIプログラムバンク-MIDI音源としての音色群
SDE_DATA_TYPE_SHOT_DATAワンショットデータ
SDE_DATA_TYPE_SHOT_BANKワンショットバンク-ワンショットデータの集まり
SDE_DATA_TYPE_PSTM_DATAPCMストリームデータ(将来サポート予定)
SDE_DATA_TYPE_PSTM_RING_BUFPCMストリームデータを再生するためのリングバッファ 実際にデータとして存在するわけではなく管理上の定義
SDE_DATA_TYPE_FX_OUT_BANKFXアウトバンク-DSPの最終出力パラメータの集まりであるFXアウトプットデータの集まり
SDE_DATA_TYPE_FX_PRG_BANKFXプログラムバンク-DSPのコードであるFXプログラムの集まり
SDE_DATA_TYPE_FX_PRG_WRKFXプログラムワーク-SDE_PSTM_RING_BUFと同様に管理上の定義


備考

sdMultiUnitDownload()関数でマルチユニットファイルをダウンロードしないと メモリマッピングがされない為、この関数は使用できません。

エラーのタイプが SDE_ERR_DATA_ILLEGAL_TYPE(データタイプが異常)の場合、 マルチユニットでないものを指定したり、ライブラリが識別できないデータIDが入ったマルチユニットをダウンロードしようとしたことが考えられます。


参照

sdMultiUnitDownload()

sdBankDownload
COPYRIGHT © SEGA ENTERPRISES, LTD., 1998