Microsoft DirectX 8.0 (Visual Basic) |
Downloads the DLS data for instruments in the band to a performance object. Once a band has been downloaded, the instruments in the band can be selected, either individually with program change MIDI messages, or all at once by playing a band segment created through a call to the DirectMusicBand8.CreateSegment method.
object.Download(downloadpath As Unknown)
If the method fails, and Err.Number can be set to one of the following values:
DMUS_E_NOT_INIT |
DMUS_E_OUTOFMEMORY |
Because a downloaded band uses synthesizer resources, it should be unloaded when no longer needed by using the DirectMusicBand8.Unload method.
If DMUS_E_NOT_INIT is raised, it usually means that the performance was not properly connected to an initialized port. Since this is a complete failure, there is no need to call DirectMusicBand8.Unload later.
If the download only partially succeeds, no error is raised but some instruments might not play. The following are some common causes of a partial download: