Platform SDK: DirectX |
DirectMusicBandDirectDownload メソッドは、バンド内の音色の DLS データをパフォーマンス オブジェクトにダウンロードする。バンドのダウンロードが終わると、そのバンド内の音色は、プログラム チェンジ MIDI メッセージにより個別に選択するか、DirectMusicBand.CreateSegment メソッドを呼び出して作成したバンド セグメントを演奏することにより一度にすべてを選択できる。
object.Download(performance As DirectMusicPerformance)
失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。
DMUS_E_NOT_INIT |
DMUS_E_OUTOFMEMORY |
ダウンロードされたバンドはシンセサイザ リソースを使用するため、不要になったときは、DirectMusicBand.Unload メソッドを使ってアンロードしなければならない。
現在のバージョンの DirectMusic の場合、ポートが DLS をサポートしていなくても成功することがある。
DMUS_E_NOT_INIT が返された場合は、通常、初期化されたポートにパフォーマンスが正常に接続されなかったことを意味する。これは完全な失敗であるため、後で DirectMusicBand.Unload を呼び出す必要はない。
ダウンロードが部分的に成功する場合、エラーは返されないが、一部の音色が演奏されない場合がある。部分的なダウンロードが発生する一般的な原因を以下に示す。