KSPROPSETID_Synth_Dls

The KSPROPSETID_Synth_Dls property set contains properties that are used to download DLS samples and instruments to a MIDI synthesizer. These are the properties of a synth node (KSNODETYPE_SYNTHESIZER) on a DirectMusic pin of a DirectMusic filter (see MIDI and DirectMusic Filters).

This section describes the behavior of these properties with regard to how they download and unload "chunks" of memory containing DLS data. The actual format of the downloaded instrument and wave data chunks is specified in the low-level DLS discussion in the Platform SDK documentation.

DLS downloads and unloads can occur at any time during the pin’s existence. Unlike DirectMusic events, they are not time-stamped and should be processed as soon as possible.

In this section, the term DLS resource, or just resource, refers to either a DLS instrument chunk or a DLS wave chunk. The system properly maintains reference counts on all DLS resources:

• When a client unloads the last instrument referencing a wave, the system automatically generates a call to unload the wave.
• Conversely, the system defers the call to unload a wave until the client unloads the last instrument referencing the wave.

The property items in this set are specified by KSPROPERTY_SYNTH_DLS enumeration values.

The KSPROPERTYSETID_Synth_Dls property set contains the following properties:

KSPROPERTY_SYNTH_DLS_APPEND

KSPROPERTY_SYNTH_DLS_COMPACT

KSPROPERTY_SYNTH_DLS_DOWNLOAD

KSPROPERTY_SYNTH_DLS_UNLOAD

KSPROPERTY_SYNTH_DLS_WAVEFORMAT