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