| Microsoft DirectX 9.0 SDK Update (Summer 2004) |
IDirectMusicPortDownload8 Interface
The IDirectMusicPortDownload8 interface enables an application to communicate directly with a port that supports
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.