Platform SDK: DirectX |
IDirectMusicPortDownload::Download メソッドは、ウェーブまたは楽器の定義をポートにダウンロードする。最初に IDirectMusicPortDownload::AllocateBuffer メソッドを使って、メモリを割り当てなければならない。
HRESULT Download( IDirectMusicDownload* pIDMDownload );
戻り値はポートの実装によって決まる。
成功すれば S_OK を返す。
失敗すれば次のエラー値のいずれかを返す。
ダウンロードするデータの準備方法については、「下位レベル DLS」を参照すること。
メモリをダウンロードした後、それ以上何かを行うことはできない。ダウンロードを更新するには、新しいバッファを作成し、IDirectMusicPortDownload::GetDLId メソッドを使って取得した新しいダウンロード ID を割り当て、その ID を送信しなければならない。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dmusicc.h で宣言。
IDirectMusicPortDownload::Unload、DMUS_DOWNLOADINFO、DMUS_OFFSETTABLE