//-----------------------------------------------------------------------------
// 
// Sample Name: VoiceManagement Sample
// 
// Copyright (c) 1999-2001 Microsoft Corporation. All rights reserved.
// 
//-----------------------------------------------------------------------------


Description
===========
  The VoiceManagement sample shows how to implement dynamic voice management 
  when creating DirectSound secondary buffers.

Path
====
  Source: DXSDK\Samples\Multimedia\DSound\VoiceManagement

  Executable: DXSDK\Samples\Multimedia\DSound\Bin

User's Guide
============
  Load a wave file by clicking Sound File. Select Voice Allocation Flags, 
  Buffer Priority, and Voice Management Flags options. Note that the effect 
  of the selected options is described under Expected Behavior. Create the 
  buffer and play the sound by clicking Play. 

Programming Notes
=================
  For a simpler example of how to setup a DirectSound buffer without 
  voice management flags, see the PlaySound sample. 
  
  To use voice management flags, the buffer must be created using 
  DSBCAPS_LOCDEFER otherwise DirectSound will not be able to dynamically 
  place the buffer in either hardware or software at runtime. 
  
  When playing the buffer just call IDirectSoundBuffer::Play with a 
  valid combination of voice management flags.  Run the sample to observe
  the expected result of any combination of flags.