Microsoft DirectX 8.1 (C++)

IDirectMusicPort8::UnloadInstrument

The UnloadInstrument method unloads a previously downloaded DLS instrument.

Syntax

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 error values shown in the following table.

Return code
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