Platform SDK: DirectX

IDirectMusicPort::Compact

IDirectMusicPort::Compact メソッドを使って、DLS またはウェーブテーブルのメモリをコンパクト化するようポートに指示する。この結果、ダウンロードされる新しい音色が、最大限の連続したメモリ チャンクを利用できる。

HRESULT Compact();

パラメータ

なし。

戻り値

成功すれば S_OK を返す。

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

E_FAIL
E_INVALIDARG
E_NOTIMPL
E_OUTOFMEMORY

注意

このメソッドは、独自のウェーブテーブル メモリを管理する必要のある DLS デバイスにだけ影響する。独自のメモリを管理しないポート (ホスト システムのメモリを利用するソフトウェア シンセサイザやハードウェア シンセサイザ) に対し、このメソッドは E_NOTIMPL を返す。

動作環境

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