Microsoft DirectX 8.0 (C++)

IDirectMusicPort8::UnloadInstrument

Unloads a previously downloaded DLS instrument.

HRESULT UnloadInstrument(
  IDirectMusicDownloadedInstrument *pDownloadedInstrument
);

Parameters

pDownloadedInstrument
Address of an IDirectMusicDownloadedInstrument8 interface, obtained when the instrument was downloaded by calling the IDirectMusicPort8::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 IDirectMusicPort8::DownloadInstrument.

Requirements

  Header: Declared in dmusicc.h.

See Also

Working with Instruments