//-----------------------------------------------------------------------------
// 
// Sample Name: AudioPath Sample
// 
// Copyright (c) 1999-2001 Microsoft Corporation. All rights reserved.
//
// GM/GS® Sound Set Copyright ©1996, Roland Corporation U.S.
// 
//-----------------------------------------------------------------------------



Description
===========
  The AudioPath sample demonstrates how different sounds can be played 
  on an audiopath, and how the parameters of all sounds are affected 
  by changes made on the audiopath.

Path
====
  Source: DXSDK\Samples\Multimedia\DirectMusic\AudioPath

  Executable: DXSDK\Samples\Multimedia\DirectMusic\Bin

User's Guide
============
  Click Lullaby, Snore, and Mumble to play different sounds. Adjust the 
  3-D position of the sounds by using the sliders. Click Rude Awakening 
  to play a different sound and stop all other sounds.

Programming Notes
=================
  The AudioPath sample is very similar in form to the PlayAudio sample.  For 
  detailed programming notes on the basics this sample, refer to Programming 
  Notes section of the PlayAudio sample.
  
  The AudioPath differs by showing some of the various uses of an
  audiopath. Here's how:
  
  * Upon init. See OnInitDialog()
        1. Calls IDirectMusicPerformance8::CreateStandardAudioPath passing
           in DMUS_APATH_DYNAMIC_3D to create a 3D audiopath named g_p3DAudiopath.
        2. Uses the CMusicManager framework class to create CMusicSegments from a 
           list a list of files.  
        3. Gets the IDirectSound3DListener from the 3D audiopath, and 
           calls SetRolloffFactor to set a new rolloff factor.
  
  * Upon 3D positoin slider change.  See SetPosition()
        1. Calls IDirectMusicAudioPath::GetObjectInPath on the 3D audiopath to
           get the IDirectSound3DBuffer from it.
        2. Calls IDirectSound3DBuffer::SetPosition to set a new 3D position on
           the buffer of the audiopath.
        3. Releases the 3D buffer.
        
  * Upon button click.  See PlaySegment().
        - If its the first button, "Lullaby", this plays the primary segment
          on the 3D audiopath by calling PlaySegmentEx passing in 
          DMUS_SEGF_DEFAULT and the 3D audiopath.
        - If its the second or third button, this plays a secondary segment
          on the 3D audiopath by calling PlaySegmentEx passing in 
          DMUS_SEGF_DEFAULT | DMUS_SEGF_SECONDARY and the 3D audiopath.
        - If its the forth button, "Rude Awakening", this plays a primary segment
          on the 3D audiopath by calling PlaySegmentEx passing in 
          the 3D audiopath, and setting the pFrom to the 3D audiopath. 
          This causes all currently playing segments to stop when this one starts.