Platform SDK: DirectX

IDirectMusicPortDownload::Download

IDirectMusicPortDownload::Download メソッドは、ウェーブまたは楽器の定義をポートにダウンロードする。最初に IDirectMusicPortDownload::AllocateBuffer メソッドを使って、メモリを割り当てなければならない。

HRESULT Download(
  IDirectMusicDownload* pIDMDownload
);

パラメータ

pIDMDownload
バッファ用の IDirectMusicDownload インターフェイスのアドレス。

戻り値

戻り値はポートの実装によって決まる。

成功すれば S_OK を返す。

失敗すれば次のエラー値のいずれかを返す。

E_POINTER
E_FAIL
DMUS_E_ALREADY_DOWNLOADED
DMUS_E_BADARTICULATION
DMUS_E_BADINSTRUMENT
DMUS_E_BADOFFSETTABLE
DMUS_E_BADWAVE
DMUS_E_BADWAVELINK
DMUS_E_BUFFERNOTSET
DMUS_E_NOARTICULATION
DMUS_E_NOTMONO
DMUS_E_NOTPCM
DMUS_E_UNKNOWNDOWNLOAD

注意

ダウンロードするデータの準備方法については、「下位レベル DLS」を参照すること。

メモリをダウンロードした後、それ以上何かを行うことはできない。ダウンロードを更新するには、新しいバッファを作成し、IDirectMusicPortDownload::GetDLId メソッドを使って取得した新しいダウンロード ID を割り当て、その ID を送信しなければならない。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusicc.h で宣言。

参照

IDirectMusicPortDownload::UnloadDMUS_DOWNLOADINFODMUS_OFFSETTABLE