Platform SDK: DirectX

IDirectMusicPort::UnloadInstrument

IDirectMusicPort::UnloadInstrument メソッドは、以前にダウンロードした DLS 音色をアンロードするために使われる。

HRESULT UnloadInstrument(
  IDirectMusicDownloadedInstrument *pDownloadedInstrument
);

パラメータ

pDownloadedInstrument
IDirectMusicPort::DownloadInstrument メソッドを呼び出して音色をダウンロードしたときに取得した、IDirectMusicDownloadedInstrument インターフェイスのアドレス。

戻り値

成功すれば S_OK を返す。

失敗すれば次のエラー値のいずれかを返す。

DMUS_E_NOT_DOWNLOADED_TO_PORT
E_POINTER
E_NOTIMPL

注意

IDirectMusicPort::DownloadInstrument によって割り当てられたメモリを解放するには、このメソッドを呼び出さなければならない。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusicc.h で宣言。

参照

音色の操作