Microsoft DirectX 8.0 (C++) |
音色に対応する 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 |
音色のダウンロードは通常、バンドによって処理されるため、ほとんどのアプリケーションではこのメソッドを使う必要がない。「バンドのダウンロードとアンロード」を参照すること。
パフォーマンス チャンネルがポートに割り当てられていない場合、このメソッドは E_INVALIDARG を返す。
リソースの浪費を防ぐには、音色が不要になったときに、IDirectMusicPort8::UnloadInstrument メソッドを使ってアンロードする。
ヘッダー : dmusici.h で宣言。
IDirectMusicPort8::DownloadInstrument、IDirectMusicPort8::UnloadInstrument、音色の操作