Microsoft DirectX 8.0 (Visual Basic)

DirectMusicBand8.Download

バンド内の音色の DLS データをパフォーマンス オブジェクトにダウンロードする。バンドのダウンロードが終わると、そのバンド内の音色は、プログラム チェンジ MIDI メッセージにより個別に選択するか、DirectMusicBand8.CreateSegment メソッドを呼び出して作成したバンド セグメントを演奏することにより一度にすべてを選択できる。

object.Download(downloadpath As Unknown)

指定項目

object
DirectMusicBand8 オブジェクトを指定する。
downloadpath
どのパスでバンドを実行するかを指定する DirectMusicAudioPath8 オブジェクトか DirectMusicPerformance8 オブジェクト。

エラー コード

失敗した場合は、Err.Number に次のいずれかの値が設定される。

DMUS_E_NOT_INIT
DMUS_E_OUTOFMEMORY

注意

ダウンロードされたバンドはシンセサイザ リソースを使用するため、不要になったときは、DirectMusicBand8.Unload メソッドを使ってアンロードしなければならない。

DMUS_E_NOT_INIT が返された場合は、通常、初期化されたポートにパフォーマンスが正常に接続されなかったことを意味する。これは完全な失敗であるため、後で DirectMusicBand8.Unload を呼び出す必要はない。

ダウンロードが部分的に成功する場合、エラーは返されないが、一部の音色が演奏されない場合がある。部分的なダウンロードが発生する一般的な原因を以下に示す。