Microsoft DirectX 8.0 (C++)

IDirectMusicPortDownload8::Download

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

HRESULT Download(
  IDirectMusicDownload* pIDMDownload
);

パラメータ

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

戻り値

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

成功した場合は 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」を参照すること。

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

動作環境

  ヘッダー : dmusicc.h で宣言。

参照

IDirectMusicPortDownload8::UnloadDMUS_DOWNLOADINFODMUS_OFFSETTABLE