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
** Minimum Supported Client:** Windows 2000.
** Minimum Supported Server:** Windows 2000 Server.
** Header:** Dmusicc.h
See Also