Platform SDK: DirectX |
IDirectMusicPerformance::DownloadInstrument メソッドは、音色の DLS データをポートにダウンロードする。
HRESULT DownloadInstrument( IDirectMusicInstrument* pInst, DWORD dwPChannel, IDirectMusicDownloadedInstrument** ppDownInst, DMUS_NOTERANGE* pNoteRanges, DWORD dwNumNoteRanges, IDirectMusicPort** ppPort, DWORD* pdwGroup, DWORD* pdwMChannel );
成功すれば S_OK を返す。
失敗すれば次のエラー値のいずれかを返す。
E_INVALIDARG |
E_POINTER |
音色のダウンロードは通常、バンドによって処理されるため、ほとんどのアプリケーションではこのメソッドを使う必要がない。「バンドのダウンロードとアンロード」を参照すること。
P チャンネルがポートに割り当てられていない場合、このメソッドは E_INVALIDARG を返す。
リソースの浪費を防ぐには、音色が不要になったときに、IDirectMusicPort::UnloadInstrument メソッドを使ってアンロードする。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dmusici.h で宣言。
IDirectMusicPort::DownloadInstrument,、IDirectMusicPort::UnloadInstrument、音色の操作