Microsoft DirectX 9.0 SDK Update (Summer 2004) |
Standard Audiopaths
If your application does not play exclusively on audiopaths created from audiopath configuration objects, you must create one or more standard audiopaths.
Standard audiopaths are identified by the values passed in the dwType parameter of IDirectMusicPerformance8::CreateStandardAudioPath or in the dwDefaultPathType parameter of IDirectMusicPerformance8::InitAudio.
The audiopaths defined by DirectMusic manage the flow of synthesizer output through combinations of standard buffers, some of which have effect
Audiopath type | Standard buffers | Buffer shared? |
DMUS_APATH_DYNAMIC_3D | 3-D Dry | No |
DMUS_APATH_DYNAMIC_MONO | Mono | No |
DMUS_APATH_DYNAMIC_STEREO | Stereo | No |
DMUS_APATH_SHARED_STEREOPLUSREVERB | Music Reverb |
Yes Yes |
Characteristics of the standard buffers are shown in the following table, where the Capabilities column lists values returned in the dwFlags member of the DSBCAPS structure passed to IDirectSoundBuffer8::GetCaps. The last column shows interfaces that can be obtained from the buffer object. In addition, applications can add effects to buffers by using IDirectSoundBuffer8::SetFX, making other interfaces available. For more information on obtaining interfaces, see Retrieving Objects from an Audiopath.
Standard buffer | Description | Capabilities | Interfaces |
3-D Dry | Mono 3-D buffer | DSBCAPS_CTRL3D DSBCAPS_CTRLFREQUENCY DSBCAPS_CTRLFX DSBCAPS_CTRLVOLUME DSBCAPS_GLOBALFOCUS DSBCAPS_MUTE3DATMAXDISTANCE |
IDirectSound3DBuffer8 IDirectSoundBuffer8 IDirectSound3DBuffer8 |
Mono | Mono buffer with no effects | DSBCAPS_CTRLFREQUENCY DSBCAPS_CTRLFX DSBCAPS_CTRLPAN DSBCAPS_CTRLVOLUME DSBCAPS_GLOBALFOCUS |
IDirectSoundBuffer8 |
Music | Stereo buffer used with Reverb | DSBCAPS_CTRLFX DSBCAPS_CTRLPAN DSBCAPS_CTRLVOLUME DSBCAPS_GLOBALFOCUS |
IDirectSoundBuffer8 |
Reverb | Stereo buffer with music reverberation effect | DSBCAPS_CTRLFX DSBCAPS_CTRLPAN DSBCAPS_CTRLVOLUME DSBCAPS_GLOBALFOCUS |
IDirectSoundFXWavesReverb8 IDirectSoundBuffer8 |
Stereo | Stereo buffer with no effects | DSBCAPS_CTRLFREQUENCY, DSBCAPS_CTRLFX, DSBCAPS_CTRLPAN DSBCAPS_CTRLVOLUME DSBCAPS_GLOBALFOCUS |
IDirectSoundBuffer8 |
More information about the standard audiopaths is available in the following topics:
- DMUS_APATH_DYNAMIC_3D
- DMUS_APATH_DYNAMIC_MONO
- DMUS_APATH_DYNAMIC_STEREO
- DMUS_APATH_SHARED_STEREOPLUSREVERB
© 2004 Microsoft Corporation. All rights reserved.