DirectMusicBand8.Download

The Download method 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)

Parts

object

Resolves to a DirectMusicBand8 object.

downloadpath

DirectMusicAudioPath8 or DirectMusicPerformance8 object that specifies the path on which the band is to perform.

Error Codes

If the method fails, and Err.Number can be set to one of the following values:

Remarks

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:

• The band has instruments on performance channels not allocated on the port.
• The band has instruments in a DLS format incompatible with the synthesizer they are being downloaded to.