Microsoft DirectX 8.1 (Visual Basic)

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 lType parameter of DirectMusicPerformance8.CreateStandardAudioPath or in the lDefaultPathType parameter of DirectMusicPerformance8.InitAudio.

The audiopaths defined by DirectMusic manage the flow of synthesizer output through combinations of standard buffers, some of which have effect DMOs attached to them. The following table shows the standard audiopaths and which standard buffers they contain. Shared buffers can be used by more than one audiopath.

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	Stereo Reverb	Yes Yes

Characteristics of the standard buffers are shown in the following table, where the Capabilities column lists values that would be returned in the lFlags member of the DSBCAPS type passed to DirectSoundSecondaryBuffer8.GetCaps. The last column shows objects that can always be obtained from the buffer object. In addition, applications can add effects to buffers by using DirectSoundSecondaryBuffer8.SetFX, in which case other objects will be available. A DirectSoundSecondaryBuffer8 object can be obtained for any buffer. For more information on obtaining objects, see Retrieving Objects from an Audiopath.

Standard Buffer	Description	Capabilities	Objects
3-D Dry	Mono 3-D buffer	DSBCAPS_CTRLFX DSBCAPS_CTRL3D DSBCAPS_CTRLFX DSBCAPS_CTRLVOLUME DSBCAPS_GLOBALFOCUS DSBCAPS_MUTE3DATMAXDISTANCE	DirectSound3DBuffer8
Mono	Mono buffer with no effects	DSBCAPS_CTRLFX DSBCAPS_CTRLPAN DSBCAPS_CTRLVOLUME DSBCAPS_GLOBALFOCUS	None.
Reverb	Stereo buffer with music reverberation effect	DSBCAPS_CTRLFX DSBCAPS_CTRLPAN DSBCAPS_CTRLVOLUME DSBCAPS_GLOBALFOCUS	DirectSoundFXWavesReverb8
Stereo	Stereo buffer with no effects	DSBCAPS_CTRLFX DSBCAPS_CTRLPAN DSBCAPS_CTRLVOLUME DSBCAPS_GLOBALFOCUS	None.

More information about the standard audiopaths is available in the following topics: