/******
 *
 * Written by Dan Morris
 * dmorris@cs.stanford.edu
 * http://techhouse.brown.edu/~dmorris
 *
 * You can do anything you want with this file as long as this header
 * stays on it and I am credited when it's appropriate.
 *
 ******/

/************
 * 
 * The files you care about if you don't want to touch the source for this library
 * are the .lib and .h files in the 'lib' directory.
 *
 * This library allows routing sound files to specific audio devices and/or multiple audio
 * devices.  It's meant to be simple, so you'll have to experiment to find which device is 
 * which on your machine, but device 0 should always be the default.  The most interesting 
 * function is:
 *
 * int build_graph_for_file(const char* filename, int device_mask);
 *
 * Let's say I want to play the file "test.mp3" on devices 0 and 2.  I would say:
 *
 * int handle = build_graph_for_file("test.mp3", 0x5);
 *
 * The last parameter is a bitmask; in binary 0x5 looks like 00000101, i.e. bits
 * "0" and "2" are turned on.  I get back a handle I can pass to all the other
 * functions to start and stop playback of this file on the specified devices; I
 * do most of that with the media_control() function.
 *
 * Also, you should use the init_dshow() and cleanup_dshow() functions to fire up
 * and shut down the library.
 *
 * Any media type that your computer knows how to play - which almost always includes
 * .mp3 and .wav - should work fine.
 *
 ************/
 
 