IDirectMusicPortDownload::Download

This method downloads a wave or instrument definition to the port. The memory must first be allocated by using the IDirectMusicPortDownload::AllocateBuffer method.

HRESULT Download(
  IDirectMusicDownload* pIDMDownload
);

Parameters

• pIDMDownload
  Address of the IDirectMusicDownload interface for the buffer.

Return Values

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:

E_POINTER

E_FAIL

DMUS_E_ALREADY_DOWNLOADED

DMUS_E_BADARTICULATION

DMUS_E_BADINSTRUMENT

DMUS_E_BADOFFSETTABLE

DMUS_E_BADWAVE

DMUS_E_BADWAVELINK

DMUS_E_BUFFERNOTSET

DMUS_E_NOARTICULATION

DMUS_E_NOTMONO

DMUS_E_NOTPCM

DMUS_E_UNKNOWNDOWNLOAD

Remarks

For more information about how to prepare the data to be downloaded, see Low-Level DLS.

Once 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 IDirectMusicPortDownload::GetDLId method, then send it down.

Requirements

OS Versions: Windows CE .NET 4.0 and Windows CE .NET 4.1.
Header: Dmusicc.h.
Link Library: Dmusic.lib.

See Also

IDirectMusicDownload | IDirectMusicPortDownload::AllocateBuffer | IDirectMusicPortDownload::Unload | DMUS_DOWNLOADINFO | DMUS_OFFSETTABLE

 Last updated on Monday, April 12, 2004

© 1992-2002 Microsoft Corporation. All rights reserved.