IDirectMusicPortDownload8 Interface
Warning: This technology is deprecated as is all of DirectMusic. Deprecated components are considered obsolete. While these components are still supported, they may be removed in the future. When writing new applications, you should avoid using these deprecated components. When modifying existing applications, you are strongly encouraged to remove any dependency on these components.
Deprecated.
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
** Minimum Supported Client:** Windows 2000.
** Minimum Supported Server:** Windows 2000 Server.
** Header:** Dmusicc.h
See Also