Microsoft DirectX 8.0 (C++)

IDirectMusicPort8::UnloadInstrument

以前にダウンロードした DLS 音色をアンロードする。

HRESULT UnloadInstrument(
  IDirectMusicDownloadedInstrument *pDownloadedInstrument
);

パラメータ

pDownloadedInstrument
IDirectMusicPort8::DownloadInstrument メソッドを呼び出すことで、音色をダウンロードしたときに取得された、IDirectMusicDownloadedInstrument8 インターフェイスのアドレス。

戻り値

成功した場合は S_OK を返す。

失敗した場合は、次のいずれかのエラー値を返す。

DMUS_E_NOT_DOWNLOADED_TO_PORT
E_POINTER
E_NOTIMPL

注意

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

動作環境

  ヘッダー : dmusicc.h で宣言。

参照

音色の操作