Miles Sound System SDK 7.2a

AIL_DLS_sample_handle

The function AIL_DLS_sample_handle returns the underlying HSAMPLE associated with a given DLS synthesizer instance.

HSAMPLE AIL_DLS_sample_handle(
  HDLSDEVICE dls
);

In Parameters

dls: indicates the DLS device whose HSAMPLE should be returned.

Returns

The HSAMPLE used by the synthesizer instance to render DLS instrument output.

Discussion

In MSS 7, a number of redundant functions were replaced with this accessor function. If your application previously called AIL_DLS_set_reverb_levels, AIL_DLS_get_reverb_levels, AIL_DLS_processor, AIL_set_DLS_processor, AIL_filter_DLS_attribute, or AIL_set_filter_DLS_preference, it should be modified to call the HSAMPLE-based version of those functions after obtaining the DLS synthesizer's underlying HSAMPLE via AIL_DLS_sample_handle.

Group: DLS Services
Related Functions: AIL_DLS_sample_handle
Related Basic Types: HDLSDEVICE, HSAMPLE
Related FAQs: How do I apply a low-pass filter?, I used an older version of Miles and now my volume and pan calls are weird - what's going on? And what's with the two types of volume functions?, What's the best way to port my older Miles application to MSS 7?