Platform SDK: DirectX

DirectMusicBand.Download

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

object.Download(performance As DirectMusicPerformance)

パラメータ

object
DirectMusicBand オブジェクトを表すオブジェクト式。
performance
バンドが演奏するパフォーマンス。パフォーマンスは、チャンネルから DirectMusic ポートへのマッピングを管理する。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。

DMUS_E_NOT_INIT
DMUS_E_OUTOFMEMORY

注意

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

現在のバージョンの DirectMusic の場合、ポートが DLS をサポートしていなくても成功することがある。

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

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