Platform SDK: DirectX |
IDirectMusicPort::DownloadInstrument メソッドは、DLS デバイスに楽器をダウンロードするために使われる。音色をダウンロードすることは、音色を構成するデータを DLS デバイスに渡すことを意味する。この中には、楽器が必要とするアーティキュレーションデータとすべてのウェーブが含まれる。ウェーブのスペースを節約するために、その範囲で必要とされるウェーブとアーティキュレーションだけがダウンロードされる。このメソッドは IDirectMusicDownloadedInstrument インターフェイスポインタを返すが、これは後で楽器をアンロードするために使われる。
HRESULT DownloadInstrument( IDirectMusicInstrument *pInstrument, IDirectMusicDownloadedInstrument **ppDownloadedInstrument, DMUS_NOTERANGE *pNoteRanges, DWORD dwNumNoteRanges; );
成功すれば S_OK を返す。
失敗すれば次のエラー値のいずれかを返す。
E_POINTER |
E_OUTOFMEMORY |
E_NOTIMPL |
メモリの浪費を防ぐには、音色が不要になったときに、IDirectMusicPort::UnloadInstrument と IDirectMusicDownloadedInstrument::Release の両方を呼び出して、アンロードしなければならない。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dmusicc.h で宣言。