| DirectX SDK |
The IDirectMusicPort::Compact method is used to instruct the port to compact DLS or wave-table memory, thus making the largest possible contiguous chunk of memory available for new instruments to be downloaded.
HRESULT Compact();
None.
If the method succeeds, the return value is S_OK.
If it fails, the method can return one of the following error values:
| E_FAIL |
| E_INVALIDARG |
| E_NOTIMPL |
| E_OUTOFMEMORY |
This method only affects DLS devices that need to manage their own DLS wavetable memory. On ports that do not manage their own memory (such as software synthesizers or hardware synthesizers that utilize host system memory), the method will return E_NOTIMPL.
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
Header: Declared in dmusicc.h.