Miles Sound System SDK 7.2a

AIL_get_DirectSound_info

The function AIL_get_DirectSound_info returns the pointers to the DirectSound object currently being used by MSS.

void AIL_get_DirectSound_info(
  HSAMPLE S,
  LPDIRECTSOUND *lplpDS,
  LPDIRECTSOUNDBUFFER *lplpDSB
);

In Parameters

S: indicates the sample that you want to use.

Out Parameters

lplpDS: is a pointer to a LPDIRECTSOUND variable that will receive MSS's DirectSound object pointer.
lplpDSB: is a pointer to a LPDIRECTSOUNDBUFFER variable that will receive this sample's DirectSoundBuffer object pointer.

Discussion

This function is Windows only.

To get the pointer to the DirectSoundBuffer object, you must call AIL_start_sample at least once before calling this function (a DirectSoundBuffer object isn't assigned until you play the sample).

If MSS isn't currently using DirectSound, then this function will simply return.

You can pass NULL for any of the parameters that you aren't interested in.

Group: Digital Audio Services
Related Functions: AIL_open_digital_driver, AIL_start_sample
Related Basic Types: HSAMPLE, LPDIRECTSOUND, LPDIRECTSOUNDBUFFER, void