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