Platform SDK: DirectX

IDirectMusicPort::UnloadInstrument

The IDirectMusicPort::UnloadInstrument method is used to unload a previously downloaded DLS instrument.

HRESULT UnloadInstrument(
  IDirectMusicDownloadedInstrument *pDownloadedInstrument
);

Parameters

pDownloadedInstrument
Address of an IDirectMusicDownloadedInstrument interface, obtained when the instrument was downloaded by calling the IDirectMusicPort::DownloadInstrument method.

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method can return one of the following error values:

DMUS_E_NOT_DOWNLOADED_TO_PORT
E_POINTER
E_NOTIMPL

Remarks

This method must be called to free memory allocated by IDirectMusicPort::DownloadInstrument.

Requirements

  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.

See Also

Working with Instruments