Microsoft DirectX 9.0 SDK Update (October 2004)

IDirectMusicPortDownload8 Interface

The IDirectMusicPortDownload8 interface enables an application to communicate directly with a port that supports DLS downloading and to download memory chunks directly to the port. The interface is used primarily by authoring applications that edit DLS instruments directly.

To obtain the IDirectMusicPortDownload8 interface, call the IDirectMusicPort8::QueryInterface method, passing in IID_IDirectMusicPortDownload8 as the interface GUID. If the port does not support DLS downloading, this call might fail.

In addition to the methods inherited from IUnknown, the IDirectMusicPortDownload8 interface exposes the following methods.

Buffers

Method	Description
AllocateBuffer	Creates a buffer for downloading DLS data to the port.
GetAppend	Retrieves the amount of memory that the port needs to be appended to the end of a download buffer.
GetBuffer	Retrieves the pointer of a buffer whose unique identifier is known.
GetDLId	Obtains sequential identifiers for one or more download buffers.

Data

Method	Description
Download	Downloads a waveform or instrument definition to the port.
Unload	Unloads a buffer that was previously downloaded.

The LPDIRECTMUSICPORTDOWNLOAD8 type is defined as a pointer to this interface.

typedef IDirectMusicPortDownload8 *LPDIRECTMUSICPORTDOWNLOAD8;

Requirements

Header: Dmusicc.h

See Also