Soundライブラリ - データユーティリティ関数

sdBankDownload

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

書式

SDE_ERR sdBankDownload( handle, bank_type, bank_num ) 
SDMEMBLK handle 
const SDE_DATA_TYPE bank_type 
const 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,1999