# サウンドデータユーティリティAPI

API分別名 | API名 | 機能
--- | --- | ---
サウンドデータユーティリティAPI | `sdMultiUnitDownload` | メインメモリ上にあるマルチユニットファイルのダウンロードをする．
`sdBankDownload` | メインメモリ上にある各種サウンドデータのダウンロードをする．

## sdMultiUnitDownload

プロトタイプ | `SDE_ERR sdMultiUnitDownload( SDMEMBLK handle);`
機能 | メインメモリ上にあるマルチユニットファイルのサウンドメモリへのダウンロードをする．
引数 |

`handle` | ... | ダウンロードするデータのブロック情報のハンドル．

返値 |

`SDE_ERR_NO_INIT` | ... | サウンドライブラリを初期化していない．
`SDE_ERR_HANDLE_NULL` | ... | ハンドルが`NULL`だった．
`SDE_ERR_HANDLE_ILLEGAL_VALUE` | ... | ハンドルがおかしなアドレスを指している．
`SDE_ERR_DATA_ILLEGAL_TYPE` | ... | データタイプが異常．マルチユニットでないものを指定したりライブラリが識別できないデータIDが入ったマルチユニットをダウンロードしようとした．

備考 |
参照 | `SDMEMBLK`

## sdBankDownload

プロトタイプ | `SDE_ERR sdBankDownload( 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` | ... | データタイプが異常．マルチユニットでないものを指定したりライブラリが識別できないデータIDが入ったマルチユニットをダウンロードしようとした．

備考 | 必ず一度`sdMultiUnitDownload`でマルチユニットファイルをダウンロードしなければ，このAPIは使用できません（メモリマッピングがされない為）
参照 | `SDMEMBLK`，`SDE_DATA_TYPE`