IDirectMusicPortDownload8 Interface

DirectMusic

Microsoft DirectX 9.0 SDK Update (Summer 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: Declared in dmusicc.h.

See Also


© 2004 Microsoft Corporation. All rights reserved.