##### 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