Microsoft DirectX 8.0 (C++) |
Downloads a wave or instrument definition to the port. The memory must first be allocated by using the IDirectMusicPortDownload8::AllocateBuffer method.
HRESULT Download( IDirectMusicDownload* pIDMDownload );
Return values are determined by the implementation of the port.
If the method succeeds, it returns S_OK.
If the method fails, it can return one of the following values:
For more information on how to prepare the data to be downloaded, see Low-Level DLS.
After the memory has been downloaded, you cannot do anything more with it. To update the download, you must create a new buffer and assign it a new download ID obtained by using the IDirectMusicPortDownload8::GetDLId method, and then send it down.
Header: Declared in dmusicc.h.
IDirectMusicPortDownload8::Unload, DMUS_DOWNLOADINFO, DMUS_OFFSETTABLE