auto import from //branches/cupcake/...@130745

5 files changed, 1553 insertions, 1610 deletions

diff --git a/arm-wt-22k/host_src/eas.h b/arm-wt-22k/host_src/eas.h
index 949e66e..524601e 100644
--- a/arm-wt-22k/host_src/eas.h
+++ b/arm-wt-22k/host_src/eas.h
@@ -1,17 +1,17 @@
-/*----------------------------------------------------------------------------

- *

- * File: 

- * eas.h

- *

- * Contents and purpose:

- * The public interface header for the EAS synthesizer.

- *

- * This header only contains declarations that are specific

- * to this implementation.  

- *

- * DO NOT MODIFY THIS FILE!

- *			

- * Copyright Sonic Network Inc. 2005, 2006

+/*----------------------------------------------------------------------------
+ *
+ * File: 
+ * eas.h
+ *
+ * Contents and purpose:
+ * The public interface header for the EAS synthesizer.
+ *
+ * This header only contains declarations that are specific
+ * to this implementation.  
+ *
+ * DO NOT MODIFY THIS FILE!
+ *			
+ * Copyright Sonic Network Inc. 2005, 2006
 
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -24,1040 +24,1039 @@
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- *

- *----------------------------------------------------------------------------

- * Revision Control:

- *   $Revision: 852 $

- *   $Date: 2007-09-04 11:43:49 -0700 (Tue, 04 Sep 2007) $

- *----------------------------------------------------------------------------

-*/

-

-#ifndef _EAS_H

-#define _EAS_H

-

-#include "eas_types.h"

-

-/* for C++ linkage */

-#ifdef __cplusplus

-extern "C" {

-#endif

-

-/* library version macro */

-#define MAKE_LIB_VERSION(a,b,c,d) (((((((EAS_U32) a <<8) | (EAS_U32) b) << 8) | (EAS_U32) c) << 8) | (EAS_U32) d)

-#define LIB_VERSION MAKE_LIB_VERSION(3, 6, 10, 14)

-

-typedef struct

-{

-	EAS_U32		libVersion;

-	EAS_BOOL	checkedVersion;

-	EAS_I32		maxVoices;

-	EAS_I32		numChannels;

-	EAS_I32		sampleRate;

-	EAS_I32		mixBufferSize;

-	EAS_BOOL	filterEnabled;

-	EAS_U32		buildTimeStamp;

-	EAS_CHAR 	*buildGUID;

-} S_EAS_LIB_CONFIG;

-

-/* enumerated effects module numbers for configuration */

-typedef enum

-{

-	EAS_MODULE_ENHANCER = 0,

-	EAS_MODULE_COMPRESSOR,

-	EAS_MODULE_REVERB,

-	EAS_MODULE_CHORUS,

-	EAS_MODULE_WIDENER,

-	EAS_MODULE_GRAPHIC_EQ,

-	EAS_MODULE_WOW,

-	EAS_MODULE_MAXIMIZER,

-	EAS_MODULE_TONECONTROLEQ,

-	NUM_EFFECTS_MODULES

-} E_FX_MODULES;

-

-/* enumerated optional module numbers for configuration */

-typedef enum

-{

-	EAS_MODULE_MMAPI_TONE_CONTROL = 0,

-	EAS_MODULE_METRICS

-} E_OPT_MODULES;

-#define NUM_OPTIONAL_MODULES	2

-

-/* enumerated audio decoders for configuration */

-typedef enum

-{

-	EAS_DECODER_PCM = 0,

-	EAS_DECODER_SMAF_ADPCM,

-	EAS_DECODER_IMA_ADPCM,

-	EAS_DECODER_7BIT_SMAF_ADPCM,

-	EAS_DECODER_NOT_SUPPORTED

-} E_DECODER_MODULES;

-#define NUM_DECODER_MODULES		4

-

-/* defines for EAS_PEOpenStream flags parameter */

-#define PCM_FLAGS_STEREO		0x00000100	/* stream is stereo */

-#define PCM_FLAGS_8_BIT			0x00000001	/* 8-bit format */

-#define PCM_FLAGS_UNSIGNED		0x00000010	/* unsigned format */

-#define PCM_FLAGS_STREAMING		0x80000000	/* streaming mode */

-

-/* maximum volume setting */

-#define EAS_MAX_VOLUME			100

-

-/*----------------------------------------------------------------------------

- * EAS_Init()

- *----------------------------------------------------------------------------

- * Purpose:

- * Initialize the synthesizer library

- *

- * Inputs:

- *  polyphony		- number of voices to play (dynamic memory model only)

- *	ppLibData		- pointer to data handle variable for this instance

- *

- * Outputs:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_Init (EAS_DATA_HANDLE *ppEASData);

-

-/*----------------------------------------------------------------------------

- * EAS_Config()

- *----------------------------------------------------------------------------

- * Purpose:

- * Returns a pointer to a structure containing the configuration options

- * in this library build.

- *

- * Inputs:

- *

- * Outputs:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC const S_EAS_LIB_CONFIG *EAS_Config (void);

-

-/*----------------------------------------------------------------------------

- * EAS_Shutdown()

- *----------------------------------------------------------------------------

- * Purpose:

- * Shuts down the library. Deallocates any memory associated with the

- * synthesizer (dynamic memory model only)

- *

- * Inputs:

- *	pEASData		- handle to data for this instance

- *

- * Outputs:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_Shutdown (EAS_DATA_HANDLE pEASData);

-

-/*----------------------------------------------------------------------------

- * EAS_Render()

- *----------------------------------------------------------------------------

- * Purpose:

- * Parse the Midi data and render PCM audio data.

- *

- * Inputs:

- *  pEASData        - buffer for internal EAS data

- *	pOut			- output buffer pointer

- *	nNumRequested	- requested num samples to generate

- *	pnNumGenerated	- actual number of samples generated

- *

- * Outputs:

- *	EAS_SUCCESS if PCM data was successfully rendered

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_Render (EAS_DATA_HANDLE pEASData, EAS_PCM *pOut, EAS_I32 numRequested, EAS_I32 *pNumGenerated);

-

-/*----------------------------------------------------------------------------

- * EAS_SetRepeat()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Set the selected stream to repeat.

- *

- * Inputs:

- *	pEASData		- handle to data for this instance

- *	streamHandle	- handle to stream

- *	repeatCount		- repeat count (0 = no repeat, -1 = repeat forever)

- *		

- * Outputs:

- *

- * Side Effects:

- *

- * Notes:

- *	0 = no repeat

- *	1 = repeat once, i.e. play through twice

- *  -1 = repeat forever

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_SetRepeat (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 repeatCount);

-

-/*----------------------------------------------------------------------------

- * EAS_GetRepeat()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Gets the current repeat count for the selected stream.

- *

- * Inputs:

- *	pEASData		- handle to data for this instance

- *	streamHandle	- handle to stream

- *	pRrepeatCount	- pointer to variable to hold repeat count

- *		

- * Outputs:

- *

- * Side Effects:

- *

- * Notes:

- *	0 = no repeat

- *	1 = repeat once, i.e. play through twice

- *  -1 = repeat forever

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_GetRepeat (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 *pRepeatCount);

-

-/*----------------------------------------------------------------------------

- * EAS_SetPlaybackRate()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Set the playback rate.

- *

- * Inputs:

- *	pEASData		- handle to data for this instance

- *	streamHandle	- handle to stream

- *	rate			- rate (28-bit fractional amount)

- *		

- * Outputs:

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_SetPlaybackRate (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_U32 rate);

-#define MAX_PLAYBACK_RATE	(EAS_U32)(1L << 29)

-#define MIN_PLAYBACK_RATE	(EAS_U32)(1L << 27)

-

-/*----------------------------------------------------------------------------

- * EAS_SetTransposition)

- *----------------------------------------------------------------------------

- * Purpose: 

- * Sets the key tranposition for the synthesizer. Transposes all

- * melodic instruments by the specified amount. Range is limited

- * to +/-12 semitones.

- *

- * Inputs:

- *	pEASData		- handle to data for this instance

- *	streamHandle	- handle to stream

- *	transposition	- +/-12 semitones

- *		

- * Outputs:

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_SetTransposition (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 transposition);

-#define MAX_TRANSPOSE		12

-

-/*----------------------------------------------------------------------------

- * EAS_SetSynthPolyphony()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Set the polyphony of the synthesizer. Value must be >= 1 and <= the

- * maximum number of voices. This function will pin the polyphony

- * at those limits

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * synthNum			- synthesizer number (0 = onboard, 1 = DSP)

- * polyphonyCount	- the desired polyphony count

- *		

- * Outputs:

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_SetSynthPolyphony (EAS_DATA_HANDLE pEASData, EAS_I32 synthNum, EAS_I32 polyphonyCount);

-

-/*----------------------------------------------------------------------------

- * EAS_GetSynthPolyphony()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Returns the current polyphony setting of the synthesizer

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * synthNum			- synthesizer number (0 = onboard, 1 = DSP)

- * pPolyphonyCount	- pointer to variable to receive polyphony count

- *		

- * Outputs:

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_GetSynthPolyphony (EAS_DATA_HANDLE pEASData, EAS_I32 synthNum, EAS_I32 *pPolyphonyCount);

-

-/*----------------------------------------------------------------------------

- * EAS_SetPolyphony()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Set the polyphony of the stream. Value must be >= 1 and <= the

- * maximum number of voices. This function will pin the polyphony

- * at those limits

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * streamHandle		- handle returned by EAS_OpenFile

- * polyphonyCount	- the desired polyphony count

- *		

- * Outputs:

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_SetPolyphony (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 polyphonyCount);

-

-/*----------------------------------------------------------------------------

- * EAS_GetPolyphony()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Returns the current polyphony setting of the stream

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * streamHandle		- handle returned by EAS_OpenFile

- * pPolyphonyCount	- pointer to variable to receive polyphony count

- *		

- * Outputs:

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_GetPolyphony (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 *pPolyphonyCount);

-

-/*----------------------------------------------------------------------------

- * EAS_SetPriority()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Set the priority of the stream. Determines which stream's voices

- * are stolen when there are insufficient voices for all notes.

- * Value must be in the range of 1-255, lower values are higher

- * priority. The default priority is 50.

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * streamHandle		- handle returned by EAS_OpenFile

- * polyphonyCount	- the desired polyphony count

- *		

- * Outputs:

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_SetPriority (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 priority);

-

-/*----------------------------------------------------------------------------

- * EAS_GetPriority()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Returns the current priority setting of the stream

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * streamHandle		- handle returned by EAS_OpenFile

- * pPriority		- pointer to variable to receive priority

- *		

- * Outputs:

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_GetPriority (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 *pPriority);

-

-/*----------------------------------------------------------------------------

- * EAS_SetVolume()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Set the master volume for the mixer. The default volume setting is

- * 90 (-10 dB). The volume range is 0 to 100 in 1dB increments.

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * volume			- the desired master volume

- *		

- * Outputs:

- *

- *

- * Side Effects:

- * overrides any previously set master volume from sysex

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_SetVolume (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 volume);

-

-/*----------------------------------------------------------------------------

- * EAS_GetVolume()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Returns the master volume for the mixer in 1dB increments.

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * volume			- the desired master volume

- *		

- * Outputs:

- *

- *

- * Side Effects:

- * overrides any previously set master volume from sysex

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_I32 EAS_GetVolume (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle);

-

-/*----------------------------------------------------------------------------

- * EAS_SetMaxLoad()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Sets the maximum workload the parsers will do in a single call to

- * EAS_Render. The units are currently arbitrary, but should correlate

- * well to the actual CPU cycles consumed. The primary effect is to

- * reduce the occasional peaks in CPU cycles consumed when parsing

- * dense parts of a MIDI score. Setting maxWorkLoad to zero disables

- * the workload limiting function.

- *

- * Inputs:

- *	pEASData		- handle to data for this instance

- *	maxLoad			- the desired maximum workload

- *		

- * Outputs:

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_SetMaxLoad (EAS_DATA_HANDLE pEASData, EAS_I32 maxLoad);

-

-/*----------------------------------------------------------------------------

- * EAS_SetMaxPCMStreams()

- *----------------------------------------------------------------------------

- * Sets the maximum number of PCM streams allowed in parsers that

- * use PCM streaming.

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * streamHandle		- handle returned by EAS_OpenFile

- * maxNumStreams	- maximum number of PCM streams

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_SetMaxPCMStreams (EAS_DATA_HANDLE pEASData, EAS_HANDLE pStream, EAS_I32 maxNumStreams);

-

-/*----------------------------------------------------------------------------

- * EAS_OpenFile()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Opens a file for audio playback.

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * locator			- pointer to filename or other locating information

- * pStreamHandle	- pointer to stream handle variable

- * memfailvar		- pointer to var to set to indicate memory access failure

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_OpenFile (EAS_DATA_HANDLE pEASData, EAS_FILE_LOCATOR locator, EAS_HANDLE *pStreamHandle, int **memfailvar);

-

-#ifdef MMAPI_SUPPORT

-/*----------------------------------------------------------------------------

- * EAS_MMAPIToneControl()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Opens a ToneControl file for audio playback.

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * locator			- pointer to filename or other locating information

- * pStreamHandle	- pointer to stream handle variable

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_MMAPIToneControl (EAS_DATA_HANDLE pEASData, EAS_FILE_LOCATOR locator, EAS_HANDLE *pStreamHandle);

-

-/*----------------------------------------------------------------------------

- * EAS_GetWaveFmtChunk

- *----------------------------------------------------------------------------

- * Helper function to retrieve WAVE file fmt chunk for MMAPI

- *----------------------------------------------------------------------------

- * pEASData			- pointer to EAS persistent data object

- * streamHandle		- stream handle

- * pFmtChunk		- pointer to pointer to FMT chunk data

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_GetWaveFmtChunk (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_VOID_PTR *ppFmtChunk);

-#endif

-

-/*----------------------------------------------------------------------------

- * EAS_GetFileType

- *----------------------------------------------------------------------------

- * Returns the file type (see eas_types.h for enumerations)

- *----------------------------------------------------------------------------

- * pEASData			- pointer to EAS persistent data object

- * streamHandle		- stream handle

- * pFileType		- pointer to variable to receive file type

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_GetFileType (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 *pFileType);

-

-/*----------------------------------------------------------------------------

- * EAS_ParseMetaData()

- *----------------------------------------------------------------------------

- * Purpose: 

- * 

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * streamHandle		- file or stream handle

- * playLength		- pointer to variable to store the play length (in msecs)

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *					- resets the parser to the start of the file

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_ParseMetaData (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 *pPlayLength);

-

-/*----------------------------------------------------------------------------

- * EAS_Prepare()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Prepares the synthesizer to play the file or stream. Parses the first

- * frame of data from the file and arms the synthesizer.

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * streamHandle		- file or stream handle

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_Prepare (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle);

-

-/*----------------------------------------------------------------------------

- * EAS_State()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Returns the state of an audio file or stream. 

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * streamHandle		- file or stream handle

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_State (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_STATE *pState);

-

-/*----------------------------------------------------------------------------

- * EAS_RegisterMetaDataCallback()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Registers a metadata callback function for parsed metadata. To

- * de-register the callback, call this function again with parameter

- * cbFunc set to NULL.

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * streamHandle		- file or stream handle

- * cbFunc			- pointer to host callback function

- * metaDataBuffer	- pointer to metadata buffer

- * metaDataBufSize	- maximum size of the metadata buffer

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_RegisterMetaDataCallback (

-	EAS_DATA_HANDLE pEASData, 

-	EAS_HANDLE streamHandle, 

-	EAS_METADATA_CBFUNC cbFunc, 

-	char *metaDataBuffer, 

-	EAS_I32 metaDataBufSize, 

-	EAS_VOID_PTR pUserData);

-

-/*----------------------------------------------------------------------------

- * EAS_GetNoteCount ()

- *----------------------------------------------------------------------------

- * Returns the total number of notes played in this stream

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * streamHandle		- file or stream handle

- * pNoteCount		- pointer to variable to receive note count

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_GetNoteCount (EAS_DATA_HANDLE pEASData, EAS_HANDLE pStream, EAS_I32 *pNoteCount);

-

-/*----------------------------------------------------------------------------

- * EAS_CloseFile()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Closes an audio file or stream. Playback should have either paused or

- * completed (EAS_State returns EAS_PAUSED or EAS_STOPPED).

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * streamHandle		- file or stream handle

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_CloseFile (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle);

-

-/*----------------------------------------------------------------------------

- * EAS_OpenMIDIStream()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Opens a raw MIDI stream allowing the host to route MIDI cable data directly to the synthesizer

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * pStreamHandle	- pointer to variable to hold file or stream handle

- * streamHandle		- open stream or NULL for new synthesizer instance

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_OpenMIDIStream (EAS_DATA_HANDLE pEASData, EAS_HANDLE *pStreamHandle, EAS_HANDLE streamHandle);

-

-/*----------------------------------------------------------------------------

- * EAS_WriteMIDIStream()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Send data to the MIDI stream device

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * streamHandle		- stream handle

- * pBuffer			- pointer to buffer

- * count			- number of bytes to write

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_WriteMIDIStream(EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_U8 *pBuffer, EAS_I32 count);

-

-/*----------------------------------------------------------------------------

- * EAS_CloseMIDIStream()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Closes a raw MIDI stream

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * streamHandle		- stream handle

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_CloseMIDIStream (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle);

-

-/*----------------------------------------------------------------------------

- * EAS_Locate()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Locate into the file associated with the handle.

- *

- * Inputs:

- * pEASData 		- pointer to overall EAS data structure

- * streamHandle		- file handle

- * milliseconds		- playback offset from start of file in milliseconds

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- * the actual offset will be quantized to the closest update period, typically

- * a resolution of 5.9ms. Notes that are started prior to this time will not

- * sound. Any notes currently playing will be shut off.

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_Locate (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 milliseconds, EAS_BOOL offset);

-

-/*----------------------------------------------------------------------------

- * EAS_GetRenderTime()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Returns the current playback offset 

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- *		

- * Outputs:

- * Gets the render time clock in msecs.

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_GetRenderTime (EAS_DATA_HANDLE pEASData, EAS_I32 *pTime);

-

-/*----------------------------------------------------------------------------

- * EAS_GetLocation()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Returns the current playback offset 

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * streamHandle		- file handle

- *		

- * Outputs:

- * The offset in milliseconds from the start of the current sequence, quantized

- * to the nearest update period. Actual resolution is typically 5.9 ms.

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_GetLocation (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 *pTime);

-

-/*----------------------------------------------------------------------------

- * EAS_Pause()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Pauses the playback of the data associated with this handle. The audio

- * is gracefully ramped down to prevent clicks and pops. It may take several

- * buffers of audio before the audio is muted.

- *

- * Inputs:

- * psEASData		- pointer to overall EAS data structure

- * streamHandle		- file or stream handle

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_Pause (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle);

-

-/*----------------------------------------------------------------------------

- * EAS_Resume()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Resumes the playback of the data associated with this handle. The audio

- * is gracefully ramped up to prevent clicks and pops.

- *

- * Inputs:

- * psEASData		- pointer to overall EAS data structure

- * streamHandle		- file or stream handle

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_Resume (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle);

-

-/*----------------------------------------------------------------------------

- * EAS_GetParameter()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Set the parameter of a module. See E_MODULES for a list of modules

- * and the header files of the modules for a list of parameters.

- *

- * Inputs:

- * psEASData		- pointer to overall EAS data structure

- * module			- enumerated module number

- * param			- enumerated parameter number

- * pValue			- pointer to variable to receive parameter value

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_GetParameter (EAS_DATA_HANDLE pEASData, EAS_I32 module, EAS_I32 param, EAS_I32 *pValue);

-

-/*----------------------------------------------------------------------------

- * EAS_SetParameter()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Set the parameter of a module. See E_MODULES for a list of modules

- * and the header files of the modules for a list of parameters.

- *

- * Inputs:

- * psEASData		- pointer to overall EAS data structure

- * handle			- file or stream handle

- * module			- enumerated module number

- * param			- enumerated parameter number

- * value			- new parameter value

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_SetParameter (EAS_DATA_HANDLE pEASData, EAS_I32 module, EAS_I32 param, EAS_I32 value);

-

-#ifdef _METRICS_ENABLED	

-/*----------------------------------------------------------------------------

- * EAS_MetricsReport()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Displays the current metrics through the EAS_Report interface.

- *

- * Inputs:

- * pEASData				- instance data handle

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_MetricsReport (EAS_DATA_HANDLE pEASData);

-

-/*----------------------------------------------------------------------------

- * EAS_MetricsReset()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Displays the current metrics through the EAS_Report interface.

- *

- * Inputs:

- * pEASData				- instance data handle

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_MetricsReset (EAS_DATA_HANDLE pEASData);

-#endif

-

-/*----------------------------------------------------------------------------

- * EAS_SetSoundLibrary()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Sets the location of the sound library.

- *

- * Inputs:

- * pEASData				- instance data handle

- * streamHandle			- file or stream handle

- * pSoundLib			- pointer to sound library

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_SetSoundLibrary (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_SNDLIB_HANDLE pSndLib);

-

-/*----------------------------------------------------------------------------

- * EAS_SetHeaderSearchFlag()

- *----------------------------------------------------------------------------

- * By default, when EAS_OpenFile is called, the parsers check the

- * first few bytes of the file looking for a specific header. Some

- * mobile devices may add a header to the start of a file, which

- * will prevent the parser from recognizing the file. If the

- * searchFlag is set to EAS_TRUE, the parser will search the entire

- * file looking for the header. This may enable EAS to recognize

- * some files that it would ordinarily reject. The negative is that

- * it make take slightly longer to process the EAS_OpenFile request.

- *

- * Inputs:

- * pEASData				- instance data handle

- * searchFlag			- search flag (EAS_TRUE or EAS_FALSE)

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_SetHeaderSearchFlag (EAS_DATA_HANDLE pEASData, EAS_BOOL searchFlag);

-

-/*----------------------------------------------------------------------------

- * EAS_SetPlayMode()

- *----------------------------------------------------------------------------

- * Some file formats support special play modes, such as iMode partial

- * play mode. This call can be used to change the play mode. The

- * default play mode (usually straight playback) is always zero.

- *

- * Inputs:

- * pEASData				- instance data handle

- * handle				- file or stream handle

- * playMode				- play mode (see eas_types.h for enumerations)

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_SetPlayMode (EAS_DATA_HANDLE pEASData, EAS_HANDLE pStream, EAS_I32 playMode);

-

-#ifdef DLS_SYNTHESIZER

-/*----------------------------------------------------------------------------

- * EAS_LoadDLSCollection()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Downloads a DLS collection

- *

- * Inputs:

- * pEASData				- instance data handle

- * streamHandle			- file or stream handle

- * locator				- file locator

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- * May overlay instruments in the GM sound set

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_LoadDLSCollection (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_FILE_LOCATOR locator);

-#endif

-

-/*----------------------------------------------------------------------------

- * EAS_SetFrameBuffer()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Sets the frame buffer pointer passed to the IPC communications functions

- *

- * Inputs:

- * pEASData				- instance data handle

- * locator				- file locator

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- * May overlay instruments in the GM sound set

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_SetFrameBuffer (EAS_DATA_HANDLE pEASData, EAS_FRAME_BUFFER_HANDLE pFrameBuffer);

-

-#ifdef EXTERNAL_AUDIO

-/*----------------------------------------------------------------------------

- * EAS_RegExtAudioCallback()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Registers callback functions for audio events.

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * streamHandle		- file or stream handle

- * cbProgChgFunc	- pointer to host callback function for program change

- * cbEventFunc		- pointer to host callback functio for note events

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_RegExtAudioCallback (EAS_DATA_HANDLE pEASData,

-	EAS_HANDLE streamHandle,

-	EAS_VOID_PTR pInstData,

-	EAS_EXT_PRG_CHG_FUNC cbProgChgFunc,

-	EAS_EXT_EVENT_FUNC cbEventFunc);

-

-/*----------------------------------------------------------------------------

- * EAS_GetMIDIControllers()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Returns the current state of MIDI controllers on the requested channel.

- *

- * Inputs:

- * pEASData			- pointer to overall EAS data structure

- * streamHandle		- file or stream handle

- * pControl			- pointer to structure to receive data

- *		

- * Outputs:

- * 

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-EAS_PUBLIC EAS_RESULT EAS_GetMIDIControllers (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_U8 channel, S_MIDI_CONTROLLERS *pControl);

-#endif

-

-/*----------------------------------------------------------------------------

- * EAS_SearchFile

- *----------------------------------------------------------------------------

- * Search file for specific sequence starting at current file

- * position. Returns offset to start of sequence.

- *

- * Inputs:

- * pEASData			- pointer to EAS persistent data object

- * fileHandle		- file handle

- * searchString		- pointer to search sequence

- * len				- length of search sequence

- * pOffset			- pointer to variable to store offset to sequence

- *

- * Returns EAS_EOF if end-of-file is reached

- *----------------------------------------------------------------------------

-*/

-EAS_RESULT EAS_SearchFile (EAS_DATA_HANDLE pEASData, EAS_FILE_HANDLE fileHandle, const EAS_U8 *searchString, EAS_I32 len, EAS_I32 *pOffset);

-

-#ifdef __cplusplus

-} /* end extern "C" */

-#endif

-

-#endif /* #ifndef _EAS_H */

+ *
+ *----------------------------------------------------------------------------
+ * Revision Control:
+ *   $Revision: 852 $
+ *   $Date: 2007-09-04 11:43:49 -0700 (Tue, 04 Sep 2007) $
+ *----------------------------------------------------------------------------
+*/
+
+#ifndef _EAS_H
+#define _EAS_H
+
+#include "eas_types.h"
+
+/* for C++ linkage */
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* library version macro */
+#define MAKE_LIB_VERSION(a,b,c,d) (((((((EAS_U32) a <<8) | (EAS_U32) b) << 8) | (EAS_U32) c) << 8) | (EAS_U32) d)
+#define LIB_VERSION MAKE_LIB_VERSION(3, 6, 10, 14)
+
+typedef struct
+{
+	EAS_U32		libVersion;
+	EAS_BOOL	checkedVersion;
+	EAS_I32		maxVoices;
+	EAS_I32		numChannels;
+	EAS_I32		sampleRate;
+	EAS_I32		mixBufferSize;
+	EAS_BOOL	filterEnabled;
+	EAS_U32		buildTimeStamp;
+	EAS_CHAR 	*buildGUID;
+} S_EAS_LIB_CONFIG;
+
+/* enumerated effects module numbers for configuration */
+typedef enum
+{
+	EAS_MODULE_ENHANCER = 0,
+	EAS_MODULE_COMPRESSOR,
+	EAS_MODULE_REVERB,
+	EAS_MODULE_CHORUS,
+	EAS_MODULE_WIDENER,
+	EAS_MODULE_GRAPHIC_EQ,
+	EAS_MODULE_WOW,
+	EAS_MODULE_MAXIMIZER,
+	EAS_MODULE_TONECONTROLEQ,
+	NUM_EFFECTS_MODULES
+} E_FX_MODULES;
+
+/* enumerated optional module numbers for configuration */
+typedef enum
+{
+	EAS_MODULE_MMAPI_TONE_CONTROL = 0,
+	EAS_MODULE_METRICS
+} E_OPT_MODULES;
+#define NUM_OPTIONAL_MODULES	2
+
+/* enumerated audio decoders for configuration */
+typedef enum
+{
+	EAS_DECODER_PCM = 0,
+	EAS_DECODER_SMAF_ADPCM,
+	EAS_DECODER_IMA_ADPCM,
+	EAS_DECODER_7BIT_SMAF_ADPCM,
+	EAS_DECODER_NOT_SUPPORTED
+} E_DECODER_MODULES;
+#define NUM_DECODER_MODULES		4
+
+/* defines for EAS_PEOpenStream flags parameter */
+#define PCM_FLAGS_STEREO		0x00000100	/* stream is stereo */
+#define PCM_FLAGS_8_BIT			0x00000001	/* 8-bit format */
+#define PCM_FLAGS_UNSIGNED		0x00000010	/* unsigned format */
+#define PCM_FLAGS_STREAMING		0x80000000	/* streaming mode */
+
+/* maximum volume setting */
+#define EAS_MAX_VOLUME			100
+
+/*----------------------------------------------------------------------------
+ * EAS_Init()
+ *----------------------------------------------------------------------------
+ * Purpose:
+ * Initialize the synthesizer library
+ *
+ * Inputs:
+ *  polyphony		- number of voices to play (dynamic memory model only)
+ *	ppLibData		- pointer to data handle variable for this instance
+ *
+ * Outputs:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_Init (EAS_DATA_HANDLE *ppEASData);
+
+/*----------------------------------------------------------------------------
+ * EAS_Config()
+ *----------------------------------------------------------------------------
+ * Purpose:
+ * Returns a pointer to a structure containing the configuration options
+ * in this library build.
+ *
+ * Inputs:
+ *
+ * Outputs:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC const S_EAS_LIB_CONFIG *EAS_Config (void);
+
+/*----------------------------------------------------------------------------
+ * EAS_Shutdown()
+ *----------------------------------------------------------------------------
+ * Purpose:
+ * Shuts down the library. Deallocates any memory associated with the
+ * synthesizer (dynamic memory model only)
+ *
+ * Inputs:
+ *	pEASData		- handle to data for this instance
+ *
+ * Outputs:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_Shutdown (EAS_DATA_HANDLE pEASData);
+
+/*----------------------------------------------------------------------------
+ * EAS_Render()
+ *----------------------------------------------------------------------------
+ * Purpose:
+ * Parse the Midi data and render PCM audio data.
+ *
+ * Inputs:
+ *  pEASData        - buffer for internal EAS data
+ *	pOut			- output buffer pointer
+ *	nNumRequested	- requested num samples to generate
+ *	pnNumGenerated	- actual number of samples generated
+ *
+ * Outputs:
+ *	EAS_SUCCESS if PCM data was successfully rendered
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_Render (EAS_DATA_HANDLE pEASData, EAS_PCM *pOut, EAS_I32 numRequested, EAS_I32 *pNumGenerated);
+
+/*----------------------------------------------------------------------------
+ * EAS_SetRepeat()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Set the selected stream to repeat.
+ *
+ * Inputs:
+ *	pEASData		- handle to data for this instance
+ *	streamHandle	- handle to stream
+ *	repeatCount		- repeat count (0 = no repeat, -1 = repeat forever)
+ *		
+ * Outputs:
+ *
+ * Side Effects:
+ *
+ * Notes:
+ *	0 = no repeat
+ *	1 = repeat once, i.e. play through twice
+ *  -1 = repeat forever
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_SetRepeat (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 repeatCount);
+
+/*----------------------------------------------------------------------------
+ * EAS_GetRepeat()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Gets the current repeat count for the selected stream.
+ *
+ * Inputs:
+ *	pEASData		- handle to data for this instance
+ *	streamHandle	- handle to stream
+ *	pRrepeatCount	- pointer to variable to hold repeat count
+ *		
+ * Outputs:
+ *
+ * Side Effects:
+ *
+ * Notes:
+ *	0 = no repeat
+ *	1 = repeat once, i.e. play through twice
+ *  -1 = repeat forever
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_GetRepeat (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 *pRepeatCount);
+
+/*----------------------------------------------------------------------------
+ * EAS_SetPlaybackRate()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Set the playback rate.
+ *
+ * Inputs:
+ *	pEASData		- handle to data for this instance
+ *	streamHandle	- handle to stream
+ *	rate			- rate (28-bit fractional amount)
+ *		
+ * Outputs:
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_SetPlaybackRate (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_U32 rate);
+#define MAX_PLAYBACK_RATE	(EAS_U32)(1L << 29)
+#define MIN_PLAYBACK_RATE	(EAS_U32)(1L << 27)
+
+/*----------------------------------------------------------------------------
+ * EAS_SetTransposition)
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Sets the key tranposition for the synthesizer. Transposes all
+ * melodic instruments by the specified amount. Range is limited
+ * to +/-12 semitones.
+ *
+ * Inputs:
+ *	pEASData		- handle to data for this instance
+ *	streamHandle	- handle to stream
+ *	transposition	- +/-12 semitones
+ *		
+ * Outputs:
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_SetTransposition (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 transposition);
+#define MAX_TRANSPOSE		12
+
+/*----------------------------------------------------------------------------
+ * EAS_SetSynthPolyphony()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Set the polyphony of the synthesizer. Value must be >= 1 and <= the
+ * maximum number of voices. This function will pin the polyphony
+ * at those limits
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * synthNum			- synthesizer number (0 = onboard, 1 = DSP)
+ * polyphonyCount	- the desired polyphony count
+ *		
+ * Outputs:
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_SetSynthPolyphony (EAS_DATA_HANDLE pEASData, EAS_I32 synthNum, EAS_I32 polyphonyCount);
+
+/*----------------------------------------------------------------------------
+ * EAS_GetSynthPolyphony()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Returns the current polyphony setting of the synthesizer
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * synthNum			- synthesizer number (0 = onboard, 1 = DSP)
+ * pPolyphonyCount	- pointer to variable to receive polyphony count
+ *		
+ * Outputs:
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_GetSynthPolyphony (EAS_DATA_HANDLE pEASData, EAS_I32 synthNum, EAS_I32 *pPolyphonyCount);
+
+/*----------------------------------------------------------------------------
+ * EAS_SetPolyphony()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Set the polyphony of the stream. Value must be >= 1 and <= the
+ * maximum number of voices. This function will pin the polyphony
+ * at those limits
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * streamHandle		- handle returned by EAS_OpenFile
+ * polyphonyCount	- the desired polyphony count
+ *		
+ * Outputs:
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_SetPolyphony (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 polyphonyCount);
+
+/*----------------------------------------------------------------------------
+ * EAS_GetPolyphony()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Returns the current polyphony setting of the stream
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * streamHandle		- handle returned by EAS_OpenFile
+ * pPolyphonyCount	- pointer to variable to receive polyphony count
+ *		
+ * Outputs:
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_GetPolyphony (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 *pPolyphonyCount);
+
+/*----------------------------------------------------------------------------
+ * EAS_SetPriority()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Set the priority of the stream. Determines which stream's voices
+ * are stolen when there are insufficient voices for all notes.
+ * Value must be in the range of 1-255, lower values are higher
+ * priority. The default priority is 50.
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * streamHandle		- handle returned by EAS_OpenFile
+ * polyphonyCount	- the desired polyphony count
+ *		
+ * Outputs:
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_SetPriority (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 priority);
+
+/*----------------------------------------------------------------------------
+ * EAS_GetPriority()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Returns the current priority setting of the stream
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * streamHandle		- handle returned by EAS_OpenFile
+ * pPriority		- pointer to variable to receive priority
+ *		
+ * Outputs:
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_GetPriority (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 *pPriority);
+
+/*----------------------------------------------------------------------------
+ * EAS_SetVolume()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Set the master volume for the mixer. The default volume setting is
+ * 90 (-10 dB). The volume range is 0 to 100 in 1dB increments.
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * volume			- the desired master volume
+ *		
+ * Outputs:
+ *
+ *
+ * Side Effects:
+ * overrides any previously set master volume from sysex
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_SetVolume (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 volume);
+
+/*----------------------------------------------------------------------------
+ * EAS_GetVolume()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Returns the master volume for the mixer in 1dB increments.
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * volume			- the desired master volume
+ *		
+ * Outputs:
+ *
+ *
+ * Side Effects:
+ * overrides any previously set master volume from sysex
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_I32 EAS_GetVolume (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle);
+
+/*----------------------------------------------------------------------------
+ * EAS_SetMaxLoad()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Sets the maximum workload the parsers will do in a single call to
+ * EAS_Render. The units are currently arbitrary, but should correlate
+ * well to the actual CPU cycles consumed. The primary effect is to
+ * reduce the occasional peaks in CPU cycles consumed when parsing
+ * dense parts of a MIDI score. Setting maxWorkLoad to zero disables
+ * the workload limiting function.
+ *
+ * Inputs:
+ *	pEASData		- handle to data for this instance
+ *	maxLoad			- the desired maximum workload
+ *		
+ * Outputs:
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_SetMaxLoad (EAS_DATA_HANDLE pEASData, EAS_I32 maxLoad);
+
+/*----------------------------------------------------------------------------
+ * EAS_SetMaxPCMStreams()
+ *----------------------------------------------------------------------------
+ * Sets the maximum number of PCM streams allowed in parsers that
+ * use PCM streaming.
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * streamHandle		- handle returned by EAS_OpenFile
+ * maxNumStreams	- maximum number of PCM streams
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_SetMaxPCMStreams (EAS_DATA_HANDLE pEASData, EAS_HANDLE pStream, EAS_I32 maxNumStreams);
+
+/*----------------------------------------------------------------------------
+ * EAS_OpenFile()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Opens a file for audio playback.
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * locator			- pointer to filename or other locating information
+ * pStreamHandle	- pointer to stream handle variable
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_OpenFile (EAS_DATA_HANDLE pEASData, EAS_FILE_LOCATOR locator, EAS_HANDLE *pStreamHandle);
+
+#ifdef MMAPI_SUPPORT
+/*----------------------------------------------------------------------------
+ * EAS_MMAPIToneControl()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Opens a ToneControl file for audio playback.
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * locator			- pointer to filename or other locating information
+ * pStreamHandle	- pointer to stream handle variable
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_MMAPIToneControl (EAS_DATA_HANDLE pEASData, EAS_FILE_LOCATOR locator, EAS_HANDLE *pStreamHandle);
+
+/*----------------------------------------------------------------------------
+ * EAS_GetWaveFmtChunk
+ *----------------------------------------------------------------------------
+ * Helper function to retrieve WAVE file fmt chunk for MMAPI
+ *----------------------------------------------------------------------------
+ * pEASData			- pointer to EAS persistent data object
+ * streamHandle		- stream handle
+ * pFmtChunk		- pointer to pointer to FMT chunk data
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_GetWaveFmtChunk (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_VOID_PTR *ppFmtChunk);
+#endif
+
+/*----------------------------------------------------------------------------
+ * EAS_GetFileType
+ *----------------------------------------------------------------------------
+ * Returns the file type (see eas_types.h for enumerations)
+ *----------------------------------------------------------------------------
+ * pEASData			- pointer to EAS persistent data object
+ * streamHandle		- stream handle
+ * pFileType		- pointer to variable to receive file type
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_GetFileType (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 *pFileType);
+
+/*----------------------------------------------------------------------------
+ * EAS_ParseMetaData()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * 
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * streamHandle		- file or stream handle
+ * playLength		- pointer to variable to store the play length (in msecs)
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *					- resets the parser to the start of the file
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_ParseMetaData (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 *pPlayLength);
+
+/*----------------------------------------------------------------------------
+ * EAS_Prepare()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Prepares the synthesizer to play the file or stream. Parses the first
+ * frame of data from the file and arms the synthesizer.
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * streamHandle		- file or stream handle
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_Prepare (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle);
+
+/*----------------------------------------------------------------------------
+ * EAS_State()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Returns the state of an audio file or stream. 
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * streamHandle		- file or stream handle
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_State (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_STATE *pState);
+
+/*----------------------------------------------------------------------------
+ * EAS_RegisterMetaDataCallback()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Registers a metadata callback function for parsed metadata. To
+ * de-register the callback, call this function again with parameter
+ * cbFunc set to NULL.
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * streamHandle		- file or stream handle
+ * cbFunc			- pointer to host callback function
+ * metaDataBuffer	- pointer to metadata buffer
+ * metaDataBufSize	- maximum size of the metadata buffer
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_RegisterMetaDataCallback (
+	EAS_DATA_HANDLE pEASData, 
+	EAS_HANDLE streamHandle, 
+	EAS_METADATA_CBFUNC cbFunc, 
+	char *metaDataBuffer, 
+	EAS_I32 metaDataBufSize, 
+	EAS_VOID_PTR pUserData);
+
+/*----------------------------------------------------------------------------
+ * EAS_GetNoteCount ()
+ *----------------------------------------------------------------------------
+ * Returns the total number of notes played in this stream
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * streamHandle		- file or stream handle
+ * pNoteCount		- pointer to variable to receive note count
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_GetNoteCount (EAS_DATA_HANDLE pEASData, EAS_HANDLE pStream, EAS_I32 *pNoteCount);
+
+/*----------------------------------------------------------------------------
+ * EAS_CloseFile()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Closes an audio file or stream. Playback should have either paused or
+ * completed (EAS_State returns EAS_PAUSED or EAS_STOPPED).
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * streamHandle		- file or stream handle
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_CloseFile (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle);
+
+/*----------------------------------------------------------------------------
+ * EAS_OpenMIDIStream()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Opens a raw MIDI stream allowing the host to route MIDI cable data directly to the synthesizer
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * pStreamHandle	- pointer to variable to hold file or stream handle
+ * streamHandle		- open stream or NULL for new synthesizer instance
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_OpenMIDIStream (EAS_DATA_HANDLE pEASData, EAS_HANDLE *pStreamHandle, EAS_HANDLE streamHandle);
+
+/*----------------------------------------------------------------------------
+ * EAS_WriteMIDIStream()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Send data to the MIDI stream device
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * streamHandle		- stream handle
+ * pBuffer			- pointer to buffer
+ * count			- number of bytes to write
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_WriteMIDIStream(EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_U8 *pBuffer, EAS_I32 count);
+
+/*----------------------------------------------------------------------------
+ * EAS_CloseMIDIStream()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Closes a raw MIDI stream
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * streamHandle		- stream handle
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_CloseMIDIStream (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle);
+
+/*----------------------------------------------------------------------------
+ * EAS_Locate()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Locate into the file associated with the handle.
+ *
+ * Inputs:
+ * pEASData 		- pointer to overall EAS data structure
+ * streamHandle		- file handle
+ * milliseconds		- playback offset from start of file in milliseconds
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ * the actual offset will be quantized to the closest update period, typically
+ * a resolution of 5.9ms. Notes that are started prior to this time will not
+ * sound. Any notes currently playing will be shut off.
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_Locate (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 milliseconds, EAS_BOOL offset);
+
+/*----------------------------------------------------------------------------
+ * EAS_GetRenderTime()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Returns the current playback offset 
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ *		
+ * Outputs:
+ * Gets the render time clock in msecs.
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_GetRenderTime (EAS_DATA_HANDLE pEASData, EAS_I32 *pTime);
+
+/*----------------------------------------------------------------------------
+ * EAS_GetLocation()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Returns the current playback offset 
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * streamHandle		- file handle
+ *		
+ * Outputs:
+ * The offset in milliseconds from the start of the current sequence, quantized
+ * to the nearest update period. Actual resolution is typically 5.9 ms.
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_GetLocation (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_I32 *pTime);
+
+/*----------------------------------------------------------------------------
+ * EAS_Pause()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Pauses the playback of the data associated with this handle. The audio
+ * is gracefully ramped down to prevent clicks and pops. It may take several
+ * buffers of audio before the audio is muted.
+ *
+ * Inputs:
+ * psEASData		- pointer to overall EAS data structure
+ * streamHandle		- file or stream handle
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_Pause (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle);
+
+/*----------------------------------------------------------------------------
+ * EAS_Resume()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Resumes the playback of the data associated with this handle. The audio
+ * is gracefully ramped up to prevent clicks and pops.
+ *
+ * Inputs:
+ * psEASData		- pointer to overall EAS data structure
+ * streamHandle		- file or stream handle
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_Resume (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle);
+
+/*----------------------------------------------------------------------------
+ * EAS_GetParameter()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Set the parameter of a module. See E_MODULES for a list of modules
+ * and the header files of the modules for a list of parameters.
+ *
+ * Inputs:
+ * psEASData		- pointer to overall EAS data structure
+ * module			- enumerated module number
+ * param			- enumerated parameter number
+ * pValue			- pointer to variable to receive parameter value
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_GetParameter (EAS_DATA_HANDLE pEASData, EAS_I32 module, EAS_I32 param, EAS_I32 *pValue);
+
+/*----------------------------------------------------------------------------
+ * EAS_SetParameter()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Set the parameter of a module. See E_MODULES for a list of modules
+ * and the header files of the modules for a list of parameters.
+ *
+ * Inputs:
+ * psEASData		- pointer to overall EAS data structure
+ * handle			- file or stream handle
+ * module			- enumerated module number
+ * param			- enumerated parameter number
+ * value			- new parameter value
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_SetParameter (EAS_DATA_HANDLE pEASData, EAS_I32 module, EAS_I32 param, EAS_I32 value);
+
+#ifdef _METRICS_ENABLED	
+/*----------------------------------------------------------------------------
+ * EAS_MetricsReport()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Displays the current metrics through the EAS_Report interface.
+ *
+ * Inputs:
+ * pEASData				- instance data handle
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_MetricsReport (EAS_DATA_HANDLE pEASData);
+
+/*----------------------------------------------------------------------------
+ * EAS_MetricsReset()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Displays the current metrics through the EAS_Report interface.
+ *
+ * Inputs:
+ * pEASData				- instance data handle
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_MetricsReset (EAS_DATA_HANDLE pEASData);
+#endif
+
+/*----------------------------------------------------------------------------
+ * EAS_SetSoundLibrary()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Sets the location of the sound library.
+ *
+ * Inputs:
+ * pEASData				- instance data handle
+ * streamHandle			- file or stream handle
+ * pSoundLib			- pointer to sound library
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_SetSoundLibrary (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_SNDLIB_HANDLE pSndLib);
+
+/*----------------------------------------------------------------------------
+ * EAS_SetHeaderSearchFlag()
+ *----------------------------------------------------------------------------
+ * By default, when EAS_OpenFile is called, the parsers check the
+ * first few bytes of the file looking for a specific header. Some
+ * mobile devices may add a header to the start of a file, which
+ * will prevent the parser from recognizing the file. If the
+ * searchFlag is set to EAS_TRUE, the parser will search the entire
+ * file looking for the header. This may enable EAS to recognize
+ * some files that it would ordinarily reject. The negative is that
+ * it make take slightly longer to process the EAS_OpenFile request.
+ *
+ * Inputs:
+ * pEASData				- instance data handle
+ * searchFlag			- search flag (EAS_TRUE or EAS_FALSE)
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_SetHeaderSearchFlag (EAS_DATA_HANDLE pEASData, EAS_BOOL searchFlag);
+
+/*----------------------------------------------------------------------------
+ * EAS_SetPlayMode()
+ *----------------------------------------------------------------------------
+ * Some file formats support special play modes, such as iMode partial
+ * play mode. This call can be used to change the play mode. The
+ * default play mode (usually straight playback) is always zero.
+ *
+ * Inputs:
+ * pEASData				- instance data handle
+ * handle				- file or stream handle
+ * playMode				- play mode (see eas_types.h for enumerations)
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_SetPlayMode (EAS_DATA_HANDLE pEASData, EAS_HANDLE pStream, EAS_I32 playMode);
+
+#ifdef DLS_SYNTHESIZER
+/*----------------------------------------------------------------------------
+ * EAS_LoadDLSCollection()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Downloads a DLS collection
+ *
+ * Inputs:
+ * pEASData				- instance data handle
+ * streamHandle			- file or stream handle
+ * locator				- file locator
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ * May overlay instruments in the GM sound set
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_LoadDLSCollection (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_FILE_LOCATOR locator);
+#endif
+
+/*----------------------------------------------------------------------------
+ * EAS_SetFrameBuffer()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Sets the frame buffer pointer passed to the IPC communications functions
+ *
+ * Inputs:
+ * pEASData				- instance data handle
+ * locator				- file locator
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ * May overlay instruments in the GM sound set
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_SetFrameBuffer (EAS_DATA_HANDLE pEASData, EAS_FRAME_BUFFER_HANDLE pFrameBuffer);
+
+#ifdef EXTERNAL_AUDIO
+/*----------------------------------------------------------------------------
+ * EAS_RegExtAudioCallback()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Registers callback functions for audio events.
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * streamHandle		- file or stream handle
+ * cbProgChgFunc	- pointer to host callback function for program change
+ * cbEventFunc		- pointer to host callback functio for note events
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_RegExtAudioCallback (EAS_DATA_HANDLE pEASData,
+	EAS_HANDLE streamHandle,
+	EAS_VOID_PTR pInstData,
+	EAS_EXT_PRG_CHG_FUNC cbProgChgFunc,
+	EAS_EXT_EVENT_FUNC cbEventFunc);
+
+/*----------------------------------------------------------------------------
+ * EAS_GetMIDIControllers()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Returns the current state of MIDI controllers on the requested channel.
+ *
+ * Inputs:
+ * pEASData			- pointer to overall EAS data structure
+ * streamHandle		- file or stream handle
+ * pControl			- pointer to structure to receive data
+ *		
+ * Outputs:
+ * 
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+EAS_PUBLIC EAS_RESULT EAS_GetMIDIControllers (EAS_DATA_HANDLE pEASData, EAS_HANDLE streamHandle, EAS_U8 channel, S_MIDI_CONTROLLERS *pControl);
+#endif
+
+/*----------------------------------------------------------------------------
+ * EAS_SearchFile
+ *----------------------------------------------------------------------------
+ * Search file for specific sequence starting at current file
+ * position. Returns offset to start of sequence.
+ *
+ * Inputs:
+ * pEASData			- pointer to EAS persistent data object
+ * fileHandle		- file handle
+ * searchString		- pointer to search sequence
+ * len				- length of search sequence
+ * pOffset			- pointer to variable to store offset to sequence
+ *
+ * Returns EAS_EOF if end-of-file is reached
+ *----------------------------------------------------------------------------
+*/
+EAS_RESULT EAS_SearchFile (EAS_DATA_HANDLE pEASData, EAS_FILE_HANDLE fileHandle, const EAS_U8 *searchString, EAS_I32 len, EAS_I32 *pOffset);
+
+#ifdef __cplusplus
+} /* end extern "C" */
+#endif
+
+#endif /* #ifndef _EAS_H */
diff --git a/arm-wt-22k/host_src/eas_hostmm.c b/arm-wt-22k/host_src/eas_hostmm.c
index bb9356e..132239b 100644
--- a/arm-wt-22k/host_src/eas_hostmm.c
+++ b/arm-wt-22k/host_src/eas_hostmm.c
@@ -5,15 +5,9 @@
  *
  * Contents and purpose:
  * This file contains the host wrapper functions for stdio, stdlib, etc.
- * This is a sample version that maps the requested files to an
- * allocated memory block and uses in-memory pointers to replace
- * file system calls. The file locator (EAS_FILE_LOCATOR) handle passed
- * HWOpenFile is the same one that is passed to EAS_OpenFile. If your
- * system stores data in fixed locations (such as flash) instead of
- * using a file system, you can use the locator handle to point to
- * your memory. You will need a way of knowing the length of the
- * data stored at that location in order to respond correctly in the
- * HW_FileLength function.
+ * This is a sample version that reads from a filedescriptor.
+ * The file locator (EAS_FILE_LOCATOR) handle passed to
+ * HWOpenFile is the same one that is passed to EAS_OpenFile.
  * 
  * Modify this file to suit the needs of your particular system.
  *
@@ -21,11 +15,9 @@
  * a MIDI type 1 file that can be played. 
  *
  * EAS_HW_FILE is a structure to support the file I/O functions. It
- * comprises the base memory pointer, the file read pointer, and
- * the dup flag, which when sets, indicates that the file handle has
- * been duplicated. If your system uses in-memory resources, you
- * can eliminate the duplicate handle logic, and simply copy the 
- * base memory pointer and file read pointer to the duplicate handle.
+ * comprises the file descriptor, the file read pointer, and
+ * the dup flag, which when set, indicates that the file handle has
+ * been duplicated, and offset and length within the file.
  *
  * Copyright 2005 Sonic Network Inc.
 
@@ -94,12 +86,8 @@ typedef struct eas_hw_file_tag
     EAS_I32 fileSize;
     EAS_I32 filePos;
     EAS_BOOL dup;
-    EAS_U8 *buffer;
-    EAS_I32 length;
+    int fd;
     EAS_I32 offset;
-    void *oldsigbushandler;
-    struct mediasigbushandler sigbushandler;
-    int memfailed;
 } EAS_HW_FILE;
 
 typedef struct eas_hw_inst_data_tag
@@ -118,6 +106,8 @@ pthread_key_t EAS_sigbuskey;
 */
 EAS_RESULT EAS_HWInit (EAS_HW_DATA_HANDLE *pHWInstData)
 {
+    EAS_HW_FILE *file;
+    int i;
 
     /* need to track file opens for duplicate handles */
     *pHWInstData = malloc(sizeof(EAS_HW_INST_DATA));
@@ -125,6 +115,15 @@ EAS_RESULT EAS_HWInit (EAS_HW_DATA_HANDLE *pHWInstData)
         return EAS_ERROR_MALLOC_FAILED;
 
     EAS_HWMemSet(*pHWInstData, 0, sizeof(EAS_HW_INST_DATA));
+    
+    file = (*pHWInstData)->files;
+    for (i = 0; i < EAS_MAX_FILE_HANDLES; i++)
+    {
+        file->fd = -1;
+        file++;
+    }
+
+
     return EAS_SUCCESS;
 }
 
@@ -233,12 +232,6 @@ EAS_I32 EAS_HWMemCmp (const void *s1, const void *s2, EAS_I32 amount)
  *
  *----------------------------------------------------------------------------
 */
-int * EAS_HWGetMemFailVar(EAS_FILE_HANDLE pFile)
-{
-    EAS_HW_FILE *file = pFile;
-    return &file->memfailed;
-}
-
 EAS_RESULT EAS_HWOpenFile (EAS_HW_DATA_HANDLE hwInstData, EAS_FILE_LOCATOR locator, EAS_FILE_HANDLE *pFile, EAS_FILE_MODE mode)
 {
     EAS_HW_FILE *file;
@@ -257,7 +250,7 @@ EAS_RESULT EAS_HWOpenFile (EAS_HW_DATA_HANDLE hwInstData, EAS_FILE_LOCATOR locat
     for (i = 0; i < EAS_MAX_FILE_HANDLES; i++)
     {
         /* is this slot being used? */
-        if (file->buffer == NULL)
+        if (file->fd < 0)
         {
             if (locator->path) {
                 /* open the file */
@@ -271,10 +264,14 @@ EAS_RESULT EAS_HWOpenFile (EAS_HW_DATA_HANDLE hwInstData, EAS_FILE_LOCATOR locat
 
             /* determine the file size */
             if (locator->length == 0) {
-                if (lseek(fd, 0, SEEK_END) < 0)
+                if (lseek(fd, 0, SEEK_END) < 0) {
+                    close(fd);
                     return EAS_ERROR_FILE_LENGTH;
-                if ((file->fileSize = lseek(fd, 0, SEEK_CUR)) == -1L)
+                }
+                if ((file->fileSize = lseek(fd, 0, SEEK_CUR)) == -1L) {
+                    close(fd);
                     return EAS_ERROR_FILE_LENGTH;
+                }
             }
 
             // file size was passed in
@@ -282,33 +279,12 @@ EAS_RESULT EAS_HWOpenFile (EAS_HW_DATA_HANDLE hwInstData, EAS_FILE_LOCATOR locat
                 file->fileSize = (EAS_I32) locator->length;
             }
 
-            // round offset down to page size
-            long pagesize = sysconf(_SC_PAGE_SIZE);
-            long mapoffset = locator->offset & ~(pagesize - 1);
-            long mapoffsetdelta = locator->offset - mapoffset;
-
-            void * bar = mmap(0, file->fileSize + mapoffsetdelta, PROT_READ, MAP_PRIVATE, fd, mapoffset);
-            if (bar == MAP_FAILED) {
-                    LOGE("error mapping file %d (%ld/%ld): %s\n", fd, mapoffset,
-                            file->fileSize + mapoffsetdelta, strerror(errno));
-                    close(fd);
-                    return EAS_FAILURE;
-            }
-            file->buffer = bar;
-            file->length = file->fileSize + mapoffsetdelta;
-            file->offset = mapoffsetdelta;
-            close(fd);
+            file->fd = fd;
+            file->offset = locator->offset;
 
             /* initialize some values */
             file->filePos = 0;
             file->dup = EAS_FALSE;
-            file->memfailed = 0;
-            file->sigbushandler.handlesigbus = NULL;
-            file->sigbushandler.sigbusvar = &file->memfailed;
-            file->sigbushandler.base = file->buffer;
-            file->sigbushandler.len = file->length;
-            file->oldsigbushandler = pthread_getspecific(EAS_sigbuskey);
-            pthread_setspecific(EAS_sigbuskey, &file->sigbushandler);
 
             *pFile = file;
             return EAS_SUCCESS;
@@ -335,7 +311,7 @@ EAS_RESULT EAS_HWReadFile (EAS_HW_DATA_HANDLE hwInstData, EAS_FILE_HANDLE file,
     EAS_I32 count;
 
     /* make sure we have a valid handle */
-    if (file->buffer == NULL)
+    if (file->fd < 0)
         return EAS_ERROR_INVALID_HANDLE;
 
     if (n < 0)
@@ -349,10 +325,10 @@ EAS_RESULT EAS_HWReadFile (EAS_HW_DATA_HANDLE hwInstData, EAS_FILE_HANDLE file,
       return EAS_EOF;
 
     /* copy the data to the requested location, and advance the pointer */
-    if (count)
-        EAS_HWMemCpy(pBuffer, &file->buffer[file->filePos + file->offset], count);
-    if (*file->sigbushandler.sigbusvar)
-        count = 0;
+    if (count) {
+        lseek(file->fd, file->filePos + file->offset, SEEK_SET);
+        count = read(file->fd, pBuffer, count);
+    }
     file->filePos += count;
     *pBytesRead = count;
 
@@ -373,32 +349,15 @@ EAS_RESULT EAS_HWReadFile (EAS_HW_DATA_HANDLE hwInstData, EAS_FILE_HANDLE file,
 /*lint -esym(715, hwInstData) hwInstData available for customer use */
 EAS_RESULT EAS_HWGetByte (EAS_HW_DATA_HANDLE hwInstData, EAS_FILE_HANDLE file, void *p)
 {
-
-    /* make sure we have a valid handle */
-    if (file->buffer == NULL)
-        return EAS_ERROR_INVALID_HANDLE;
-
-    /* check for end of file */
-    if (file->filePos >= file->fileSize)
-    {
-        *((EAS_U8*) p) = 0;
-        return EAS_EOF;
-    }
-
-    /* get a character from the buffer */
-    *((EAS_U8*) p) = file->buffer[file->filePos++ + file->offset];
-    if (*file->sigbushandler.sigbusvar)
-    {
-        return EAS_EOF;
-    }
-    return EAS_SUCCESS;
+    EAS_I32 numread;
+    return EAS_HWReadFile(hwInstData, file, p, 1, &numread);
 }
 
 /*----------------------------------------------------------------------------
  *
  * EAS_HWGetWord
  *
- * Returns the current location in the file 
+ * Read a 16 bit word from a file
  *
  *----------------------------------------------------------------------------
 */
@@ -469,7 +428,7 @@ EAS_RESULT EAS_HWFilePos (EAS_HW_DATA_HANDLE hwInstData, EAS_FILE_HANDLE file, E
 {
 
     /* make sure we have a valid handle */
-    if (file->buffer == NULL)
+    if (file->fd < 0)
         return EAS_ERROR_INVALID_HANDLE;
 
     *pPosition = file->filePos;
@@ -489,7 +448,7 @@ EAS_RESULT EAS_HWFileSeek (EAS_HW_DATA_HANDLE hwInstData, EAS_FILE_HANDLE file,
 {
 
     /* make sure we have a valid handle */
-    if (file->buffer == NULL)
+    if (file->fd < 0)
         return EAS_ERROR_INVALID_HANDLE;
 
     /* validate new position */	
@@ -514,7 +473,7 @@ EAS_RESULT EAS_HWFileSeekOfs (EAS_HW_DATA_HANDLE hwInstData, EAS_FILE_HANDLE fil
 {
 
     /* make sure we have a valid handle */
-    if (file->buffer == NULL)
+    if (file->fd < 0)
         return EAS_ERROR_INVALID_HANDLE;
 
     /* determine the file position */	
@@ -540,7 +499,7 @@ EAS_RESULT EAS_HWFileLength (EAS_HW_DATA_HANDLE hwInstData, EAS_FILE_HANDLE file
 {
 
     /* make sure we have a valid handle */
-    if (file->buffer == NULL)
+    if (file->fd < 0)
         return EAS_ERROR_INVALID_HANDLE;
 
     *pLength = file->fileSize;
@@ -561,7 +520,7 @@ EAS_RESULT EAS_HWDupHandle (EAS_HW_DATA_HANDLE hwInstData, EAS_FILE_HANDLE file,
     int i;
 
     /* make sure we have a valid handle */
-    if (file->buffer == NULL)
+    if (file->fd < 0)
         return EAS_ERROR_INVALID_HANDLE;
 
     /* find an empty entry in the file table */
@@ -569,17 +528,13 @@ EAS_RESULT EAS_HWDupHandle (EAS_HW_DATA_HANDLE hwInstData, EAS_FILE_HANDLE file,
     for (i = 0; i < EAS_MAX_FILE_HANDLES; i++)
     {
         /* is this slot being used? */
-        if (dupFile->buffer == NULL)
+        if (dupFile->fd < 0)
         {
-
             /* copy info from the handle to be duplicated */
             dupFile->filePos = file->filePos;
             dupFile->fileSize = file->fileSize;
-            dupFile->buffer = file->buffer;
-            dupFile->length = file->length;
+            dupFile->fd = file->fd;
             dupFile->offset = file->offset;
-            dupFile->sigbushandler = file->sigbushandler;
-            dupFile->oldsigbushandler = file->oldsigbushandler;
 
             /* set the duplicate handle flag */
             dupFile->dup = file->dup = EAS_TRUE;
@@ -609,7 +564,7 @@ EAS_RESULT EAS_HWCloseFile (EAS_HW_DATA_HANDLE hwInstData, EAS_FILE_HANDLE file1
 
 
     /* make sure we have a valid handle */
-    if (file1->buffer == NULL)
+    if (file1->fd < 0)
         return EAS_ERROR_INVALID_HANDLE;
 
     /* check for duplicate handle */
@@ -620,13 +575,13 @@ EAS_RESULT EAS_HWCloseFile (EAS_HW_DATA_HANDLE hwInstData, EAS_FILE_HANDLE file1
         for (i = 0; i < EAS_MAX_FILE_HANDLES; i++)
         {
             /* check for duplicate */
-            if ((file1 != file2) && (file2->buffer == file1->buffer))
+            if ((file1 != file2) && (file2->fd == file1->fd))
             {
                 /* is there more than one duplicate? */
                 if (dupFile != NULL)
                 {
                     /* clear this entry and return */
-                    file1->buffer = NULL;
+                    file1->fd = -1;
                     return EAS_SUCCESS;
                 }
 
@@ -645,19 +600,14 @@ EAS_RESULT EAS_HWCloseFile (EAS_HW_DATA_HANDLE hwInstData, EAS_FILE_HANDLE file1
             return EAS_ERROR_HANDLE_INTEGRITY;
 
         /* clear this entry and return */
-        file1->buffer = NULL;
+        file1->fd = -1;
         return EAS_SUCCESS;
     }
 
-    /* no duplicates -free the buffer */
-    int e = munmap(file1->buffer, file1->length);
-    if (e != 0) {
-        LOGE("error unmapping %p/%ld: %s\n", file1->buffer, file1->length, strerror(errno));
-    }
-    pthread_setspecific(EAS_sigbuskey, file1->oldsigbushandler);
-
+    /* no duplicates - close the file */
+    close(file1->fd);
     /* clear this entry and return */
-    file1->buffer = NULL;
+    file1->fd = -1;
     return EAS_SUCCESS;
 }
 
diff --git a/arm-wt-22k/host_src/eas_main.c b/arm-wt-22k/host_src/eas_main.c
index b71f543..fed600e 100644
--- a/arm-wt-22k/host_src/eas_main.c
+++ b/arm-wt-22k/host_src/eas_main.c
@@ -1,13 +1,13 @@
-/*----------------------------------------------------------------------------

- *

- * File: 

- * eas_main.c

- *

- * Contents and purpose:

- * The entry point and high-level functions for the EAS Synthesizer test

- * harness.

- *			

- * Copyright Sonic Network Inc. 2004

+/*----------------------------------------------------------------------------
+ *
+ * File: 
+ * eas_main.c
+ *
+ * Contents and purpose:
+ * The entry point and high-level functions for the EAS Synthesizer test
+ * harness.
+ *			
+ * Copyright Sonic Network Inc. 2004
 
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -20,445 +20,445 @@
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- *

- *----------------------------------------------------------------------------

- * Revision Control:

- *   $Revision: 775 $

- *   $Date: 2007-07-20 10:11:11 -0700 (Fri, 20 Jul 2007) $

- *----------------------------------------------------------------------------

-*/

-

-#ifdef _lint

-#include "lint_stdlib.h"

-#else

-#include <stdio.h>

-#include <string.h>

-#include <stdlib.h>

-#include <time.h>

-#endif

-

-#include "eas.h"

-#include "eas_wave.h"

-#include "eas_report.h"

-

-/* determines how many EAS buffers to fill a host buffer */

-#define NUM_BUFFERS			8

-

-/* default file to play if no filename is specified on the command line */

-static const char defaultTestFile[] = "test.mid";

-

-EAS_I32 polyphony;

-

-/* prototypes for helper functions */

-static void StrCopy(char *dest, const char *src, EAS_I32 size);

-static EAS_BOOL ChangeFileExt(char *str, const char *ext, EAS_I32 size);

-static EAS_RESULT PlayFile (EAS_DATA_HANDLE easData, const char* filename, const char* outputFile, const S_EAS_LIB_CONFIG *pLibConfig, void *buffer, EAS_I32 bufferSize);

-static EAS_BOOL EASLibraryCheck (const S_EAS_LIB_CONFIG *pLibConfig);

-

-/* main is defined after playfile to avoid the need for two passes through lint */

-

-/*----------------------------------------------------------------------------

- * PlayFile()

- *----------------------------------------------------------------------------

- * Purpose: 

- * This function plays the file requested by filename

- * 

- * Inputs: 

- *			

- * Outputs:

- *

- *----------------------------------------------------------------------------

-*/

-

-static EAS_RESULT PlayFile (EAS_DATA_HANDLE easData, const char* filename, const char* outputFile, const S_EAS_LIB_CONFIG *pLibConfig, void *buffer, EAS_I32 bufferSize)

-{

-	EAS_HANDLE handle;

-	EAS_RESULT result, reportResult;

-	EAS_I32 count;

-	EAS_STATE state;

-	EAS_I32 playTime;

-	char waveFilename[256];

-	WAVE_FILE *wFile;

-	EAS_INT i;

-	EAS_PCM *p;

-	EAS_FILE file;

-

-	/* determine the name of the output file */

-	wFile = NULL;

-	if (outputFile == NULL)

-	{

-		StrCopy(waveFilename, filename, sizeof(waveFilename));

-		if (!ChangeFileExt(waveFilename, "wav", sizeof(waveFilename)))

-		{

-			{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "Error in output filename %s\n", waveFilename); */ }

-			return EAS_FAILURE;

-		}

-		outputFile = waveFilename;

-	}

-

-	/* call EAS library to open file */

-	file.path = filename;

-	file.fd = 0;

-	if ((reportResult = EAS_OpenFile(easData, &file, &handle, NULL)) != EAS_SUCCESS)

-	{

-		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "EAS_OpenFile returned %ld\n", reportResult); */ }

-		return reportResult;

-	}

-

-	/* prepare to play the file */

-	if ((result = EAS_Prepare(easData, handle)) != EAS_SUCCESS)

-	{

-		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "EAS_Prepare returned %ld\n", result); */ }

-		reportResult = result;

-	}

-

-	/* get play length */

-	if ((result = EAS_ParseMetaData(easData, handle, &playTime)) != EAS_SUCCESS)

-	{

-		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "EAS_ParseMetaData returned %ld\n", result); */ }

-		return result;

-	}

-	EAS_ReportEx(_EAS_SEVERITY_NOFILTER, 0xe624f4d9, 0x00000005 , playTime / 1000, playTime % 1000);

-

-	if (reportResult == EAS_SUCCESS)

-	{

-		/* create the output file */

-		wFile = WaveFileCreate(outputFile, pLibConfig->numChannels, pLibConfig->sampleRate, sizeof(EAS_PCM) * 8);

-		if (!wFile)

-		{

-			{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "Unable to create output file %s\n", waveFilename); */ }

-			reportResult = EAS_FAILURE;

-		}

-	}

-

-	/* rendering loop */

-	while (reportResult == EAS_SUCCESS)

-	{

-

-		/* we may render several buffers here to fill one host buffer */

-		for (i = 0, p = buffer; i < NUM_BUFFERS; i++, p+= pLibConfig->mixBufferSize * pLibConfig->numChannels)

-		{

-			

-			/* get the current time */

-			if ((result = EAS_GetLocation(easData, handle, &playTime)) != EAS_SUCCESS)

-			{

-				{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "EAS_GetLocation returned %d\n",result); */ }

-				if (reportResult == EAS_SUCCESS)

-					reportResult = result;

-				break;

-			}

-			{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_DETAIL, "Parser time: %d.%03d\n", playTime / 1000, playTime % 1000); */ }

-

-			/* render a buffer of audio */

-			if ((result = EAS_Render(easData, p, pLibConfig->mixBufferSize, &count)) != EAS_SUCCESS)

-			{

-				{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "EAS_Render returned %d\n",result); */ }

-				if (reportResult == EAS_SUCCESS)

-					reportResult = result;

-			}

-		}

-

-		if (result == EAS_SUCCESS)

-		{

-			/* write it to the wave file */

-			if (WaveFileWrite(wFile, buffer, bufferSize) != bufferSize)

-			{

-				{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "WaveFileWrite failed\n"); */ }

-				reportResult = EAS_FAILURE;

-			}

-		}

-

-		if (reportResult == EAS_SUCCESS)

-		{

-			/* check stream state */

-			if ((result = EAS_State(easData, handle, &state)) != EAS_SUCCESS)

-			{

-				{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "EAS_State returned %d\n", result); */ }

-				reportResult = result;

-			}

-

-			/* is playback complete */

-			if ((state == EAS_STATE_STOPPED) || (state == EAS_STATE_ERROR))

-				break;

-		}

-	}

-

-	/* close the output file */

-	if (wFile)

-	{

-		if (!WaveFileClose(wFile))

-		{

-			{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "Error closing wave file %s\n", waveFilename); */ }

-			if (reportResult == EAS_SUCCESS)

-				result = EAS_FAILURE;

-		}

-	}

-	

-	/* close the input file */

-	if ((result = EAS_CloseFile(easData,handle)) != EAS_SUCCESS)

-	{

-		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "EAS_Close returned %ld\n", result); */ }

-		if (reportResult == EAS_SUCCESS)

-			result = EAS_FAILURE;

-	}

-

-	return reportResult;

-} /* end PlayFile */

-

-/*----------------------------------------------------------------------------

- * main()

- *----------------------------------------------------------------------------

- * Purpose: The entry point for the EAS sample application

- * 

- * Inputs: 

- *			

- * Outputs:

- *

- *----------------------------------------------------------------------------

-*/

-int main( int argc, char **argv )

-{

-	EAS_DATA_HANDLE easData;

-	const S_EAS_LIB_CONFIG *pLibConfig;

-	void *buffer;

-	EAS_RESULT result, playResult;

-	EAS_I32 bufferSize;

-	int i;

-	int temp;

-	FILE *debugFile;

-	char *outputFile = NULL;

-

-	/* set the error reporting level */

-	EAS_SetDebugLevel(_EAS_SEVERITY_INFO);

-	debugFile = NULL;

-

-	/* process command-line arguments */

-	for (i = 1; i < argc; i++)

-	{

-		/* check for switch */

-		if (argv[i][0] == '-')

-		{

-			switch (argv[i][1])

-			{

-			case 'd':

-				temp = argv[i][2];

-				if ((temp >= '0') || (temp <= '9'))

-					EAS_SetDebugLevel(temp);

-				else

-					{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_WARNING, "Invalid debug level %d\n", temp); */ }

-				break;

-			case 'f':

-				if ((debugFile = fopen(&argv[i][2],"w")) == NULL)

-					{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_WARNING, "Unable to create debug file %s\n", &argv[i][2]); */ }

-				else

-					EAS_SetDebugFile(debugFile, EAS_TRUE);

-				break;

-			case 'o':

-				outputFile = &argv[i][2];

-				break;

-			case 'p':

-				polyphony = atoi(&argv[i][2]);

-				if (polyphony < 1)

-					polyphony = 1;

-				{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "Polyphony set to %d\n", polyphony); */ }

-				break;

-			default:

-				break;

-			}

-			continue;

-		}

-	}

-

-	/* assume success */

-	playResult = EAS_SUCCESS;

-

-	/* get the library configuration */

-	pLibConfig = EAS_Config();

-	if (!EASLibraryCheck(pLibConfig))

-		return -1;

-	if (polyphony > pLibConfig->maxVoices)

-		polyphony = pLibConfig->maxVoices;

-

-	/* calculate buffer size */

-	bufferSize = pLibConfig->mixBufferSize * pLibConfig->numChannels * (EAS_I32)sizeof(EAS_PCM) * NUM_BUFFERS;

-

-	/* allocate output buffer memory */

-	buffer = malloc((EAS_U32)bufferSize);

-	if (!buffer)

-	{

-		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_FATAL, "Error allocating memory for audio buffer\n"); */ }

-		return EAS_FAILURE;

-	}

-

-	/* initialize the EAS library */

-	polyphony = pLibConfig->maxVoices;

-	if ((result = EAS_Init(&easData)) != EAS_SUCCESS)

-	{

-		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_FATAL, "EAS_Init returned %ld - aborting!\n", result); */ }

-		free(buffer);

-		return result;

-	}

-

-	/*

-	 * Some debugging environments don't allow for passed parameters.

-	 * In this case, just play the default MIDI file "test.mid"

-	 */

-	if (argc < 2)

-	{

-		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "Playing '%s'\n", defaultTestFile); */ }

-		if ((playResult = PlayFile(easData, defaultTestFile, NULL, pLibConfig, buffer, bufferSize)) != EAS_SUCCESS)

-		{

-			{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "Error %d playing file %s\n", playResult, defaultTestFile); */ }

-		}

-	}

-	/* iterate through the list of files to be played */

-	else

-	{

-		for (i = 1; i < argc; i++)

-		{

-			/* check for switch */

-			if (argv[i][0] != '-')

-			{

-

-				{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "Playing '%s'\n", argv[i]); */ }

-				if ((playResult = PlayFile(easData, argv[i], outputFile, pLibConfig, buffer, bufferSize)) != EAS_SUCCESS)

-				{

-					{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "Error %d playing file %s\n", playResult, argv[i]); */ }

-					break;

-				}

-			}

-		}

-	}

-

-	/* shutdown the EAS library */

-	if ((result = EAS_Shutdown(easData)) != EAS_SUCCESS)

-	{

-		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_FATAL, "EAS_Shutdown returned %ld\n", result); */ }

-	}

-

-	/* free the output buffer */

-	free(buffer);

-

-	/* close the debug file */

-	if (debugFile)

-		fclose(debugFile);

-

-	/* play errors take precedence over shutdown errors */

-	if (playResult != EAS_SUCCESS)

-		return playResult;

-	return result;

-} /* end main */

-

-/*----------------------------------------------------------------------------

- * StrCopy()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Safe string copy

- * 

- * Inputs: 

- *			

- * Outputs:

- *

- *----------------------------------------------------------------------------

-*/

-static void StrCopy(char *dest, const char *src, EAS_I32 size)

-{

-	int len;

-

-	strncpy(dest, src, (size_t) size-1);

-	len = (int) strlen(src);

-	if (len < size)

-		dest[len] = 0;

-} /* end StrCopy */

-

-/*----------------------------------------------------------------------------

- * ChangeFileExt()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Changes the file extension of a filename

- * 

- * Inputs: 

- *			

- * Outputs:

- *

- *----------------------------------------------------------------------------

-*/

-static EAS_BOOL ChangeFileExt(char *str, const char *ext, EAS_I32 size)

-{

-	char *p;

-

-	/* find the extension, if any */

-	p = strrchr(str,'.');

-	if (!p)

-	{

-		if ((EAS_I32)(strlen(str) + 5) > size)

-			return EAS_FALSE;

-		strcat(str,".");

-		strcat(str,ext);

-		return EAS_TRUE;

-	}

-

-	/* make sure there's room for the extension */

-	p++;

-	*p = 0;

-	if ((EAS_I32)(strlen(str) + 4) > size)

-		return EAS_FALSE;

-	strcat(str,ext);

-	return EAS_TRUE;

-} /* end ChangeFileExt */

-

-/*----------------------------------------------------------------------------

- * EASLibraryCheck()

- *----------------------------------------------------------------------------

- * Purpose: 

- * Displays the library version and checks it against the header

- * file used to build this code.

- *

- * Inputs:

- * pLibConfig		- library configuration retrieved from the library

- *		

- * Outputs:

- * returns EAS_TRUE if matched

- *

- * Side Effects:

- *

- *----------------------------------------------------------------------------

-*/

-static EAS_BOOL EASLibraryCheck (const S_EAS_LIB_CONFIG *pLibConfig)

-{

-

-	/* display the library version */

-	{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "EAS Library Version %d.%d.%d.%d\n",

-		pLibConfig->libVersion >> 24,

-		(pLibConfig->libVersion >> 16) & 0x0f,

-		(pLibConfig->libVersion >> 8) & 0x0f,

-		pLibConfig->libVersion & 0x0f); */ }

-

-	/* display some info about the library build */

-	if (pLibConfig->checkedVersion)

-		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "\tChecked library\n"); */ }

-	{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "\tMaximum polyphony: %d\n", pLibConfig->maxVoices); */ }

-	{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "\tNumber of channels: %d\n", pLibConfig->numChannels); */ }

-	{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "\tSample rate: %d\n", pLibConfig->sampleRate); */ }

-	{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "\tMix buffer size: %d\n", pLibConfig->mixBufferSize); */ }

-	if (pLibConfig->filterEnabled)

-		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "\tFilter enabled\n"); */ }

-#ifndef _WIN32_WCE

-	{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "\tLibrary Build Timestamp: %s", ctime((time_t*)&pLibConfig->buildTimeStamp)); */ }

-#endif

-	{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "\tLibrary Build ID: %s\n", pLibConfig->buildGUID); */ }

-		

-	/* check it against the header file used to build this code */

-	/*lint -e{778} constant expression used for display purposes may evaluate to zero */

-	if (LIB_VERSION != pLibConfig->libVersion)

-	{

-		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_FATAL, "Library version does not match header files. EAS Header Version %d.%d.%d.%d\n", 

-			LIB_VERSION >> 24,

-			(LIB_VERSION >> 16) & 0x0f,

-			(LIB_VERSION >> 8) & 0x0f,

-			LIB_VERSION & 0x0f); */ }

-		return EAS_FALSE;

-	}

-	return EAS_TRUE;

-} /* end EASLibraryCheck */

-

+ *
+ *----------------------------------------------------------------------------
+ * Revision Control:
+ *   $Revision: 775 $
+ *   $Date: 2007-07-20 10:11:11 -0700 (Fri, 20 Jul 2007) $
+ *----------------------------------------------------------------------------
+*/
+
+#ifdef _lint
+#include "lint_stdlib.h"
+#else
+#include <stdio.h>
+#include <string.h>
+#include <stdlib.h>
+#include <time.h>
+#endif
+
+#include "eas.h"
+#include "eas_wave.h"
+#include "eas_report.h"
+
+/* determines how many EAS buffers to fill a host buffer */
+#define NUM_BUFFERS			8
+
+/* default file to play if no filename is specified on the command line */
+static const char defaultTestFile[] = "test.mid";
+
+EAS_I32 polyphony;
+
+/* prototypes for helper functions */
+static void StrCopy(char *dest, const char *src, EAS_I32 size);
+static EAS_BOOL ChangeFileExt(char *str, const char *ext, EAS_I32 size);
+static EAS_RESULT PlayFile (EAS_DATA_HANDLE easData, const char* filename, const char* outputFile, const S_EAS_LIB_CONFIG *pLibConfig, void *buffer, EAS_I32 bufferSize);
+static EAS_BOOL EASLibraryCheck (const S_EAS_LIB_CONFIG *pLibConfig);
+
+/* main is defined after playfile to avoid the need for two passes through lint */
+
+/*----------------------------------------------------------------------------
+ * PlayFile()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * This function plays the file requested by filename
+ * 
+ * Inputs: 
+ *			
+ * Outputs:
+ *
+ *----------------------------------------------------------------------------
+*/
+
+static EAS_RESULT PlayFile (EAS_DATA_HANDLE easData, const char* filename, const char* outputFile, const S_EAS_LIB_CONFIG *pLibConfig, void *buffer, EAS_I32 bufferSize)
+{
+	EAS_HANDLE handle;
+	EAS_RESULT result, reportResult;
+	EAS_I32 count;
+	EAS_STATE state;
+	EAS_I32 playTime;
+	char waveFilename[256];
+	WAVE_FILE *wFile;
+	EAS_INT i;
+	EAS_PCM *p;
+	EAS_FILE file;
+
+	/* determine the name of the output file */
+	wFile = NULL;
+	if (outputFile == NULL)
+	{
+		StrCopy(waveFilename, filename, sizeof(waveFilename));
+		if (!ChangeFileExt(waveFilename, "wav", sizeof(waveFilename)))
+		{
+			{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "Error in output filename %s\n", waveFilename); */ }
+			return EAS_FAILURE;
+		}
+		outputFile = waveFilename;
+	}
+
+	/* call EAS library to open file */
+	file.path = filename;
+	file.fd = 0;
+	if ((reportResult = EAS_OpenFile(easData, &file, &handle)) != EAS_SUCCESS)
+	{
+		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "EAS_OpenFile returned %ld\n", reportResult); */ }
+		return reportResult;
+	}
+
+	/* prepare to play the file */
+	if ((result = EAS_Prepare(easData, handle)) != EAS_SUCCESS)
+	{
+		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "EAS_Prepare returned %ld\n", result); */ }
+		reportResult = result;
+	}
+
+	/* get play length */
+	if ((result = EAS_ParseMetaData(easData, handle, &playTime)) != EAS_SUCCESS)
+	{
+		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "EAS_ParseMetaData returned %ld\n", result); */ }
+		return result;
+	}
+	EAS_ReportEx(_EAS_SEVERITY_NOFILTER, 0xe624f4d9, 0x00000005 , playTime / 1000, playTime % 1000);
+
+	if (reportResult == EAS_SUCCESS)
+	{
+		/* create the output file */
+		wFile = WaveFileCreate(outputFile, pLibConfig->numChannels, pLibConfig->sampleRate, sizeof(EAS_PCM) * 8);
+		if (!wFile)
+		{
+			{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "Unable to create output file %s\n", waveFilename); */ }
+			reportResult = EAS_FAILURE;
+		}
+	}
+
+	/* rendering loop */
+	while (reportResult == EAS_SUCCESS)
+	{
+
+		/* we may render several buffers here to fill one host buffer */
+		for (i = 0, p = buffer; i < NUM_BUFFERS; i++, p+= pLibConfig->mixBufferSize * pLibConfig->numChannels)
+		{
+			
+			/* get the current time */
+			if ((result = EAS_GetLocation(easData, handle, &playTime)) != EAS_SUCCESS)
+			{
+				{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "EAS_GetLocation returned %d\n",result); */ }
+				if (reportResult == EAS_SUCCESS)
+					reportResult = result;
+				break;
+			}
+			{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_DETAIL, "Parser time: %d.%03d\n", playTime / 1000, playTime % 1000); */ }
+
+			/* render a buffer of audio */
+			if ((result = EAS_Render(easData, p, pLibConfig->mixBufferSize, &count)) != EAS_SUCCESS)
+			{
+				{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "EAS_Render returned %d\n",result); */ }
+				if (reportResult == EAS_SUCCESS)
+					reportResult = result;
+			}
+		}
+
+		if (result == EAS_SUCCESS)
+		{
+			/* write it to the wave file */
+			if (WaveFileWrite(wFile, buffer, bufferSize) != bufferSize)
+			{
+				{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "WaveFileWrite failed\n"); */ }
+				reportResult = EAS_FAILURE;
+			}
+		}
+
+		if (reportResult == EAS_SUCCESS)
+		{
+			/* check stream state */
+			if ((result = EAS_State(easData, handle, &state)) != EAS_SUCCESS)
+			{
+				{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "EAS_State returned %d\n", result); */ }
+				reportResult = result;
+			}
+
+			/* is playback complete */
+			if ((state == EAS_STATE_STOPPED) || (state == EAS_STATE_ERROR))
+				break;
+		}
+	}
+
+	/* close the output file */
+	if (wFile)
+	{
+		if (!WaveFileClose(wFile))
+		{
+			{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "Error closing wave file %s\n", waveFilename); */ }
+			if (reportResult == EAS_SUCCESS)
+				result = EAS_FAILURE;
+		}
+	}
+	
+	/* close the input file */
+	if ((result = EAS_CloseFile(easData,handle)) != EAS_SUCCESS)
+	{
+		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "EAS_Close returned %ld\n", result); */ }
+		if (reportResult == EAS_SUCCESS)
+			result = EAS_FAILURE;
+	}
+
+	return reportResult;
+} /* end PlayFile */
+
+/*----------------------------------------------------------------------------
+ * main()
+ *----------------------------------------------------------------------------
+ * Purpose: The entry point for the EAS sample application
+ * 
+ * Inputs: 
+ *			
+ * Outputs:
+ *
+ *----------------------------------------------------------------------------
+*/
+int main( int argc, char **argv )
+{
+	EAS_DATA_HANDLE easData;
+	const S_EAS_LIB_CONFIG *pLibConfig;
+	void *buffer;
+	EAS_RESULT result, playResult;
+	EAS_I32 bufferSize;
+	int i;
+	int temp;
+	FILE *debugFile;
+	char *outputFile = NULL;
+
+	/* set the error reporting level */
+	EAS_SetDebugLevel(_EAS_SEVERITY_INFO);
+	debugFile = NULL;
+
+	/* process command-line arguments */
+	for (i = 1; i < argc; i++)
+	{
+		/* check for switch */
+		if (argv[i][0] == '-')
+		{
+			switch (argv[i][1])
+			{
+			case 'd':
+				temp = argv[i][2];
+				if ((temp >= '0') || (temp <= '9'))
+					EAS_SetDebugLevel(temp);
+				else
+					{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_WARNING, "Invalid debug level %d\n", temp); */ }
+				break;
+			case 'f':
+				if ((debugFile = fopen(&argv[i][2],"w")) == NULL)
+					{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_WARNING, "Unable to create debug file %s\n", &argv[i][2]); */ }
+				else
+					EAS_SetDebugFile(debugFile, EAS_TRUE);
+				break;
+			case 'o':
+				outputFile = &argv[i][2];
+				break;
+			case 'p':
+				polyphony = atoi(&argv[i][2]);
+				if (polyphony < 1)
+					polyphony = 1;
+				{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "Polyphony set to %d\n", polyphony); */ }
+				break;
+			default:
+				break;
+			}
+			continue;
+		}
+	}
+
+	/* assume success */
+	playResult = EAS_SUCCESS;
+
+	/* get the library configuration */
+	pLibConfig = EAS_Config();
+	if (!EASLibraryCheck(pLibConfig))
+		return -1;
+	if (polyphony > pLibConfig->maxVoices)
+		polyphony = pLibConfig->maxVoices;
+
+	/* calculate buffer size */
+	bufferSize = pLibConfig->mixBufferSize * pLibConfig->numChannels * (EAS_I32)sizeof(EAS_PCM) * NUM_BUFFERS;
+
+	/* allocate output buffer memory */
+	buffer = malloc((EAS_U32)bufferSize);
+	if (!buffer)
+	{
+		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_FATAL, "Error allocating memory for audio buffer\n"); */ }
+		return EAS_FAILURE;
+	}
+
+	/* initialize the EAS library */
+	polyphony = pLibConfig->maxVoices;
+	if ((result = EAS_Init(&easData)) != EAS_SUCCESS)
+	{
+		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_FATAL, "EAS_Init returned %ld - aborting!\n", result); */ }
+		free(buffer);
+		return result;
+	}
+
+	/*
+	 * Some debugging environments don't allow for passed parameters.
+	 * In this case, just play the default MIDI file "test.mid"
+	 */
+	if (argc < 2)
+	{
+		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "Playing '%s'\n", defaultTestFile); */ }
+		if ((playResult = PlayFile(easData, defaultTestFile, NULL, pLibConfig, buffer, bufferSize)) != EAS_SUCCESS)
+		{
+			{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "Error %d playing file %s\n", playResult, defaultTestFile); */ }
+		}
+	}
+	/* iterate through the list of files to be played */
+	else
+	{
+		for (i = 1; i < argc; i++)
+		{
+			/* check for switch */
+			if (argv[i][0] != '-')
+			{
+
+				{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "Playing '%s'\n", argv[i]); */ }
+				if ((playResult = PlayFile(easData, argv[i], outputFile, pLibConfig, buffer, bufferSize)) != EAS_SUCCESS)
+				{
+					{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_ERROR, "Error %d playing file %s\n", playResult, argv[i]); */ }
+					break;
+				}
+			}
+		}
+	}
+
+	/* shutdown the EAS library */
+	if ((result = EAS_Shutdown(easData)) != EAS_SUCCESS)
+	{
+		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_FATAL, "EAS_Shutdown returned %ld\n", result); */ }
+	}
+
+	/* free the output buffer */
+	free(buffer);
+
+	/* close the debug file */
+	if (debugFile)
+		fclose(debugFile);
+
+	/* play errors take precedence over shutdown errors */
+	if (playResult != EAS_SUCCESS)
+		return playResult;
+	return result;
+} /* end main */
+
+/*----------------------------------------------------------------------------
+ * StrCopy()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Safe string copy
+ * 
+ * Inputs: 
+ *			
+ * Outputs:
+ *
+ *----------------------------------------------------------------------------
+*/
+static void StrCopy(char *dest, const char *src, EAS_I32 size)
+{
+	int len;
+
+	strncpy(dest, src, (size_t) size-1);
+	len = (int) strlen(src);
+	if (len < size)
+		dest[len] = 0;
+} /* end StrCopy */
+
+/*----------------------------------------------------------------------------
+ * ChangeFileExt()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Changes the file extension of a filename
+ * 
+ * Inputs: 
+ *			
+ * Outputs:
+ *
+ *----------------------------------------------------------------------------
+*/
+static EAS_BOOL ChangeFileExt(char *str, const char *ext, EAS_I32 size)
+{
+	char *p;
+
+	/* find the extension, if any */
+	p = strrchr(str,'.');
+	if (!p)
+	{
+		if ((EAS_I32)(strlen(str) + 5) > size)
+			return EAS_FALSE;
+		strcat(str,".");
+		strcat(str,ext);
+		return EAS_TRUE;
+	}
+
+	/* make sure there's room for the extension */
+	p++;
+	*p = 0;
+	if ((EAS_I32)(strlen(str) + 4) > size)
+		return EAS_FALSE;
+	strcat(str,ext);
+	return EAS_TRUE;
+} /* end ChangeFileExt */
+
+/*----------------------------------------------------------------------------
+ * EASLibraryCheck()
+ *----------------------------------------------------------------------------
+ * Purpose: 
+ * Displays the library version and checks it against the header
+ * file used to build this code.
+ *
+ * Inputs:
+ * pLibConfig		- library configuration retrieved from the library
+ *		
+ * Outputs:
+ * returns EAS_TRUE if matched
+ *
+ * Side Effects:
+ *
+ *----------------------------------------------------------------------------
+*/
+static EAS_BOOL EASLibraryCheck (const S_EAS_LIB_CONFIG *pLibConfig)
+{
+
+	/* display the library version */
+	{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "EAS Library Version %d.%d.%d.%d\n",
+		pLibConfig->libVersion >> 24,
+		(pLibConfig->libVersion >> 16) & 0x0f,
+		(pLibConfig->libVersion >> 8) & 0x0f,
+		pLibConfig->libVersion & 0x0f); */ }
+
+	/* display some info about the library build */
+	if (pLibConfig->checkedVersion)
+		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "\tChecked library\n"); */ }
+	{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "\tMaximum polyphony: %d\n", pLibConfig->maxVoices); */ }
+	{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "\tNumber of channels: %d\n", pLibConfig->numChannels); */ }
+	{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "\tSample rate: %d\n", pLibConfig->sampleRate); */ }
+	{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "\tMix buffer size: %d\n", pLibConfig->mixBufferSize); */ }
+	if (pLibConfig->filterEnabled)
+		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "\tFilter enabled\n"); */ }
+#ifndef _WIN32_WCE
+	{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "\tLibrary Build Timestamp: %s", ctime((time_t*)&pLibConfig->buildTimeStamp)); */ }
+#endif
+	{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_INFO, "\tLibrary Build ID: %s\n", pLibConfig->buildGUID); */ }
+		
+	/* check it against the header file used to build this code */
+	/*lint -e{778} constant expression used for display purposes may evaluate to zero */
+	if (LIB_VERSION != pLibConfig->libVersion)
+	{
+		{ /* dpp: EAS_ReportEx(_EAS_SEVERITY_FATAL, "Library version does not match header files. EAS Header Version %d.%d.%d.%d\n", 
+			LIB_VERSION >> 24,
+			(LIB_VERSION >> 16) & 0x0f,
+			(LIB_VERSION >> 8) & 0x0f,
+			LIB_VERSION & 0x0f); */ }
+		return EAS_FALSE;
+	}
+	return EAS_TRUE;
+} /* end EASLibraryCheck */
+
diff --git a/arm-wt-22k/lib_src/eas_mdls.c b/arm-wt-22k/lib_src/eas_mdls.c
index 7950d90..3da3b06 100644
--- a/arm-wt-22k/lib_src/eas_mdls.c
+++ b/arm-wt-22k/lib_src/eas_mdls.c
@@ -1276,7 +1276,7 @@ static EAS_RESULT Parse_data (SDLS_SYNTHESIZER_DATA *pDLSData, EAS_I32 pos, EAS_
 
 	return EAS_SUCCESS;
 }
-#elif defined_16_BIT_SAMPLES)
+#elif defined(_16_BIT_SAMPLES)
 #error "16-bit DLS conversion not implemented yet"
 #else
 #error "Must specifiy _8_BIT_SAMPLES or _16_BIT_SAMPLES"
diff --git a/arm-wt-22k/lib_src/eas_public.c b/arm-wt-22k/lib_src/eas_public.c
index 234e8cd..d67ef7e 100644
--- a/arm-wt-22k/lib_src/eas_public.c
+++ b/arm-wt-22k/lib_src/eas_public.c
@@ -615,9 +615,7 @@ EAS_RESULT EAS_OpenJETStream (EAS_DATA_HANDLE pEASData, EAS_FILE_HANDLE fileHand
  *
  *----------------------------------------------------------------------------
 */
-extern int *EAS_HWGetMemFailVar(EAS_FILE_HANDLE);
-
-EAS_PUBLIC EAS_RESULT EAS_OpenFile (EAS_DATA_HANDLE pEASData, EAS_FILE_LOCATOR locator, EAS_HANDLE *ppStream, int **memfailvar)
+EAS_PUBLIC EAS_RESULT EAS_OpenFile (EAS_DATA_HANDLE pEASData, EAS_FILE_LOCATOR locator, EAS_HANDLE *ppStream)
 {
 	EAS_RESULT result;
 	EAS_FILE_HANDLE fileHandle;
@@ -658,10 +656,6 @@ EAS_PUBLIC EAS_RESULT EAS_OpenFile (EAS_DATA_HANDLE pEASData, EAS_FILE_LOCATOR l
 			/* save the parser pointer and file handle */
 			EAS_InitStream(&pEASData->streams[streamNum], pParserModule, streamHandle);
 			*ppStream = &pEASData->streams[streamNum];
-			if (memfailvar)
-			{
-				*memfailvar = EAS_HWGetMemFailVar(fileHandle);
-			}
 			return EAS_SUCCESS;
 		}