|Microsoft DirectX 9.0|
The Download method downloads a waveform or instrument definition to the port. The memory must first be allocated by using the IDirectMusicPortDownload8::AllocateBuffer method.
HRESULT Download( IDirectMusicDownload* pIDMDownload );
Address of the IDirectMusicDownload8 interface for the buffer.
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 error values shown in the following table.
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.