windows-server-2003/multimedia/directx/dplay/dvoice/dxvoice/dvshared.cpp

/*==========================================================================
 *
 *  Copyright (C) 1999 Microsoft Corporation.  All Rights Reserved.
 *
 *  File:       dvshared.cpp
 *  Content:	Utility functions for DirectXVoice structures.
 *
 *  History:
 *   Date		By		Reason
 *   ====		==		======
 *	07/06/99	rodtoll	Created It
 *  07/26/99	rodtoll	Added support for DirectXVoiceNotify interface
 *  07/30/99	rodtoll Updated to remove references to removed wave members 
 *                      of sounddeviceconfig
 *	08/03/99	rodtoll	Updated to use new IDirectXVoiceNotify interface
 *						transport instead of old test transport
 *	08/04/99	rodtoll	Added new validation functions
 *  08/10/99	rodtoll	Removed TODO pragmas 
 *  08/25/99	rodtoll	General Cleanup/Modifications to support new 
 *						compression sub-system.  
 *						Added new DUMP functions
 *						Moved several compression functions to dvcdb 
 *  09/03/99	rodtoll	Bug #102159 - Parameter Validations on Initialize
 *  09/08/99	rodtoll	Updated for new compression structure in dump func
 *  09/10/99	rodtoll	Added DV_ValidSessionDesc function
 *				rodtoll	Various param validation code added
 *  09/10/99	rodtoll	Complete object validation funcs added
 *  09/13/99	rodtoll	Updated DV_ValidSoundDeviceConfig to reflect new struct
 *              rodtoll Updated DV_DUMP_SoundDeviceConfig for new struct
 *  09/14/99	rodtoll	Added new Init params and DV_ValidMessageArray 
 *  09/20/99	rodtoll	Added checks for memory allocation failures
 *  			rodtoll	Addes stricter checks on notify masks & used new notifyperiodmax
 *  09/29/99	rodtoll	Updated to allow specification of new voice suppression info
 *  10/04/99	rodtoll	Updated to allow initialize to take an LPUNKNOWN instead of LPVOID
 *  10/05/99	rodtoll	Additional comments
 *  10/07/99	rodtoll	Updated to handle Unicode Strings
 *  10/08/99	rodtoll	Fixed for passing NULL in the DirectSound Pointers
 *  10/15/99	rodtoll Removed check for GUID_NULL since default devices are now mapped there
 *  10/18/99	rodtoll	Fix: Calling Initialize twice passes
 *  10/20/99	rodtoll	Fix: Bug #114116 Initialize called with invalid message IDs results in crash
 *  			rodtoll Fix: Bug #114218 Parameter validation for initialize
 *  10/25/99	rodtoll	Fix: Bug #114682 Session Desc maint functions fail
 *  10/27/99	pnewson Fix: Bug #113935 - Saved AGC values should be device specific
 *  10/28/99	pnewson Bug #114176 updated DVSOUNDDEVICECONFIG struct
 *  11/10/99	rodtoll	Adding waveIN/waveOut caps and echo suppression
 *  11/17/99	rodtoll Fix: Bug #115538 - dwSize members of > sizeof struct were accepted
 *              rodtoll Fix: Bug #115827 - Calling SetNotifyMask w/no callback should fail
 *  			rodtoll	Fix: Bug #116440 - Remove unused flags 
 *  11/20/99	rodtoll	Fixed code which allows new force flags to recognize millenium debug flags
 *  11/23/99	rodtoll	Removed unrequired code.
 *				rodtoll Change error for insufficient buffer size to an info level (since expected in many cases)
 *				rodtoll	Fixed ref count problem when calling Iniitalize > 1 times (first time succesful)
 *  12/08/99	rodtoll Fix: Bug #121054 - Added support for new flags supporting capture focus
 *  12/16/99	rodtoll Updated to remove voice suppression and accept new session flags
 *  01/14/2000	rodtoll	Added DV_ValidTargetList function 
 *				rodtoll	Fixed Dump function for DVSOUNDDEVICECONFIG
 *				rodtoll	Updated DV_ValidMessageArray to remove old messages
 *  01/21/2000	pnewson Support DVSOUNDCONFIG_TESTMODE and DVRECORDVOLUME_LAST
 *  01/24/2000	pnewson Added check for valid hwnd DV_ValidSoundDeviceConfig
 *  01/27/2000	rodtoll	Bug #129934 - Update Create3DSoundBuffer to take DSBUFFERDESC  
 *						Updated param validations to check new params 
 *  01/28/2000	rodtoll	Bug #130480 - Updated so Host Migration is no longer valid ID for servers
 * 02/08/2000	rodtoll	Bug #131496 - Selecting DVTHRESHOLD_DEFAULT results in voice
 *						never being detected 
 *  03/29/2000	rodtoll	Added support for new flag: DVSOUNDCONFIG_SETCONVERSIONQUALITY
 *  06/21/2000	rodtoll	Fixed a memory leak if you Connect, Disconnect then Re-Connect.
 *				rodtoll	Bug #35767 We must implement ability to allow DSound effects processing in Voice buffers.
 *  07/22/2000	rodtoll	Bug #40284 - Initialize() and SetNotifyMask() should return invalidparam instead of invalidpointer
 *  08/28/2000	masonb  Voice Merge: Removed OSAL_* and dvosal.h, added STR_* and strutils.h
 *  08/31/2000 	rodtoll	Bug #43804 - DVOICE: dwSensitivity structure member is confusing - should be dwThreshold 
 *  09/14/2000	rodtoll	Bug #45001 - DVOICE: AV if client has targetted > 10 players 
 *  04/02/2001	simonpow	Bug #354859 Fixes for PREfast (unecessary variable declarations in
 *							DV_ValidBufferSettings method)
 *
 ***************************************************************************/

#include "dxvoicepch.h"


// Useful macros for checking record/suppression volumes
#define DV_ValidRecordVolume( x ) DV_ValidPlaybackVolume( x )
#define DV_ValidSuppressionVolume( x ) DV_ValidPlaybackVolume( x )

// VTABLES for all of the interfaces supported by the object
extern LPVOID dvcInterface[];
extern LPVOID dvsInterface[];
extern LPVOID dvtInterface[];
extern LPVOID dvServerNotifyInterface[];
extern LPVOID dvClientNotifyInterface[];

#undef DPF_MODNAME
#define DPF_MODNAME "DV_ValidTargetList"
HRESULT DV_ValidTargetList( const DVID* pdvidTargets, DWORD dwNumTargets )
{
	if( (pdvidTargets != NULL && dwNumTargets == 0) ||
	    (pdvidTargets == NULL && dwNumTargets > 0 ) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid params" );
		return DVERR_INVALIDPARAM;
	}

	if( dwNumTargets == 0 )
		return DV_OK;
	
	if( pdvidTargets != NULL &&
	    !DNVALID_READPTR( pdvidTargets, dwNumTargets*sizeof( DVID ) ) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid array of player targets" );
		return DVERR_INVALIDPOINTER;
	}

	// Search for duplicates in the targets
	for( DWORD dwIndex = 0; dwIndex < dwNumTargets; dwIndex++ )
	{
		if( pdvidTargets[dwIndex] == DVID_ALLPLAYERS && dwNumTargets > 1 )
		{
			DPFX(DPFPREP,  DVF_ERRORLEVEL, "Cannot specify allplayers (or noplayers) in addition to other ids" );
			return DVERR_INVALIDPARAM;
		}

		for( DWORD dwInnerIndex = dwIndex+1; dwInnerIndex < dwNumTargets; dwInnerIndex++ )
		{
			if( pdvidTargets[dwInnerIndex] == pdvidTargets[dwIndex] )
			{
				DPFX(DPFPREP,  DVF_ERRORLEVEL, "Duplicate found in target list" );
				return DVERR_INVALIDPARAM;
			}
		}
	}

	// Set max # of targets to ensure we don't exceed target buffer size
	if( dwNumTargets > DV_MAX_TARGETS )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "You can only have a maximum of %d targets", DV_MAX_TARGETS );
		return DVERR_NOTALLOWED;
	}

	return DV_OK;
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_ValidBufferSettings"
// DV_ValidBufferSettings
//
// This function is used to check to ensure that the buffer specified is in a valid 
// format to be used by voice.  
//
HRESULT DV_ValidBufferSettings( LPDIRECTSOUNDBUFFER lpdsBuffer, DWORD dwPriority, DWORD dwFlags, LPWAVEFORMATEX pwfxPlayFormat )
{
	// If buffer was specified make sure it's valid
	if( lpdsBuffer != NULL && 
	   !DNVALID_READPTR( lpdsBuffer, sizeof( IDirectSoundBuffer * ) ) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid pointer" );
		return DVERR_INVALIDPOINTER;
	}

	if( lpdsBuffer )
	{
		DWORD dwLength = 0;
		HRESULT hr = DS_OK;
		DWORD dwSize1 = 0, dwSize2 = 0;
		DWORD dwBufferSize1=0, dwBufferSize2=0;
		PVOID pvBuffer1 = NULL, pvBuffer2 = NULL;
		LPWAVEFORMATEX pwfxFormat = NULL;
		DWORD dwFormatSize = 0;
		DSBCAPS dsbCaps;
		DWORD dwStatus = 0;

		// Flip on a try-except block  to ensure calls into dsound don't crash on us.
		_try
		{
			// Get the format of the buffer -- make sure it matches our format
			hr = lpdsBuffer->GetFormat( pwfxFormat, 0, &dwFormatSize );

			if( hr != DSERR_INVALIDPARAM && hr != DS_OK )
			{
				DPFX(DPFPREP,  DVF_ERRORLEVEL, "Error getting format of ds buffer hr=0x%x", hr );
				return DVERR_INVALIDBUFFER;
			}

			pwfxFormat = (LPWAVEFORMATEX) new BYTE[dwFormatSize];

			if( !pwfxFormat )
			{
				DPFX(DPFPREP,  DVF_ERRORLEVEL, "Error allocating memory" );
				return DVERR_INVALIDBUFFER;
			}

			hr = lpdsBuffer->GetFormat( pwfxFormat, dwFormatSize, &dwFormatSize );

			if( FAILED( hr ) )
			{
				DPFX(DPFPREP,  DVF_ERRORLEVEL, "Error getting format of buffer hr=0x%x", hr );
				hr = DVERR_INVALIDBUFFER;
				goto VALID_EXIT;				
			}

			// Make sure the format matches
			if( memcmp( pwfxPlayFormat, pwfxFormat, sizeof( WAVEFORMATEX ) ) != 0 )
			{
				DPFX(DPFPREP,  DVF_ERRORLEVEL, "DS buffer is not of the correct format hr=0x%x", hr );
				hr = DVERR_INVALIDBUFFER;
				goto VALID_EXIT;
			}

			memset( &dsbCaps, 0x00, sizeof( DSBCAPS ) );
			dsbCaps.dwSize = sizeof( DSBCAPS );

			hr = lpdsBuffer->GetCaps( &dsbCaps );

			if( FAILED( hr ) )
			{
				DPFX(DPFPREP,  DVF_ERRORLEVEL, "Unable to get buffer caps hr=0x%x", hr );
				hr = DVERR_INVALIDBUFFER;
				goto VALID_EXIT;				
			}

			if( !(dsbCaps.dwFlags & DSBCAPS_CTRL3D) )
			{
				DPFX(DPFPREP,  DVF_ERRORLEVEL, "You must specify 3D flags for buffers hr=0x%x", hr );
				hr = DVERR_INVALIDBUFFER;
				goto VALID_EXIT;				
			}

			if( !(dsbCaps.dwFlags & DSBCAPS_GETCURRENTPOSITION2) )
			{
				DPFX(DPFPREP,  DVF_ERRORLEVEL, "You must specify ctrlposnotify for buffers hr=0x%x", hr );
				hr = DVERR_INVALIDBUFFER;
				goto VALID_EXIT;				
			}

			if( dsbCaps.dwFlags & DSBCAPS_PRIMARYBUFFER ) 
			{
				DPFX(DPFPREP,  DVF_ERRORLEVEL, "You cannot pass in a primary buffer" );
				hr = DVERR_INVALIDBUFFER;
				goto VALID_EXIT;				
			}

		
			if( dsbCaps.dwBufferBytes  < pwfxPlayFormat->nAvgBytesPerSec )
			{
				DPFX(DPFPREP,  DVF_ERRORLEVEL, "Buffer size is less then one second worth of audio" );
				hr = DVERR_INVALIDBUFFER;
				goto VALID_EXIT;				
			}

			hr = lpdsBuffer->GetStatus( &dwStatus );

			if( FAILED( hr ) )
			{
				DPFX(DPFPREP,  DVF_ERRORLEVEL, "Error getting buffer status hr=0x%x", hr );
				hr = DVERR_INVALIDBUFFER;
				goto VALID_EXIT;				
			}

			if( dwStatus & DSBSTATUS_PLAYING )
			{
				DPFX(DPFPREP,  DVF_ERRORLEVEL, "Buffer must be stopped" );
				hr = DVERR_INVALIDBUFFER;
				goto VALID_EXIT;
			}

				// Check to see if the buffer is locked already
			hr = lpdsBuffer->Lock( 0, 0, &pvBuffer1, &dwBufferSize1, &pvBuffer2, &dwBufferSize2, DSBLOCK_ENTIREBUFFER );

			if( FAILED( hr ) )
			{
				DPFX(DPFPREP,  DVF_ERRORLEVEL, "Could not lock the buffer, likely is already locked hr=0x%x", hr );
				hr = DVERR_LOCKEDBUFFER;
				goto VALID_EXIT;
			}

			lpdsBuffer->Unlock( pvBuffer1, dwBufferSize1, pvBuffer2, dwBufferSize2 );

VALID_EXIT:
			if( pwfxFormat )
				delete[] pwfxFormat;

			return hr;
		}
		_except( EXCEPTION_EXECUTE_HANDLER )
		{
			DPFX(DPFPREP,  DVF_ERRORLEVEL, "Error during validation of directsound buffer" );
			
			if( pwfxFormat )
				delete[] pwfxFormat;
			
			return DVERR_INVALIDPOINTER;
		}
	}

	return DV_OK;

}


// DV_ValidPlaybackVolume
//
// Checks the specified playback volume to ensure it's valid
BOOL DV_ValidPlaybackVolume( LONG lPlaybackVolume )
{
	if( (lPlaybackVolume >= DSBVOLUME_MIN) && (lPlaybackVolume <= DSBVOLUME_MAX) )
	{
		return TRUE;
	}
	else
	{
		return FALSE;
	}
}

// DV_ValidNotifyPeriod
//
// Checks the specified notification period to ensure it's valid
//
BOOL DV_ValidNotifyPeriod( DWORD dwNotifyPeriod ) 
{
	if( (dwNotifyPeriod == 0) || (dwNotifyPeriod >= DVNOTIFYPERIOD_MINPERIOD) )
	{
		return TRUE;
	}
	else
	{
		return FALSE;
	}
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_ValidSoundDeviceConfig"
// DV_ValidSoundDeviceConfig
//
// Checks the specified sound device configuration to ensure that it's 
// valid.
//
HRESULT DV_ValidSoundDeviceConfig( LPDVSOUNDDEVICECONFIG lpSoundDeviceConfig, LPWAVEFORMATEX pwfxPlayFormat ) 
{
	HRESULT hr;
	
	if( lpSoundDeviceConfig == NULL )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid pointer" );
		return DVERR_INVALIDPOINTER;
	}

	if( !DNVALID_READPTR( lpSoundDeviceConfig, sizeof(DVSOUNDDEVICECONFIG) ) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid read pointer" );
		return DVERR_INVALIDPOINTER;
	}

	if( lpSoundDeviceConfig->dwSize != sizeof( DVSOUNDDEVICECONFIG ) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid size" );
		return DVERR_INVALIDPARAM;
	}

	if( (lpSoundDeviceConfig->dwFlags & DVSOUNDCONFIG_NOFOCUS) &&
	    (lpSoundDeviceConfig->dwFlags & DVSOUNDCONFIG_STRICTFOCUS) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Cannot specify no focus and strictfocus" );
		return DVERR_INVALIDPARAM;
	}

	if( lpSoundDeviceConfig->dwFlags & 
	    ~(DVSOUNDCONFIG_AUTOSELECT | DVSOUNDCONFIG_HALFDUPLEX |
	      DVSOUNDCONFIG_STRICTFOCUS | DVSOUNDCONFIG_NOFOCUS | 
	      DVSOUNDCONFIG_TESTMODE | DVSOUNDCONFIG_NORMALMODE |
		  DVSOUNDCONFIG_SETCONVERSIONQUALITY | 
#if defined(_DEBUG) || defined(DEBUG) || defined(DBG)
	      DVSOUNDCONFIG_FORCEWAVEOUT | DVSOUNDCONFIG_FORCEWAVEIN | 	    
#endif
		  DVSOUNDCONFIG_ALLOWWAVEOUT | DVSOUNDCONFIG_ALLOWWAVEIN ) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid flags" );		
		return DVERR_INVALIDFLAGS;
	}

	if( (lpSoundDeviceConfig->dwFlags & DVSOUNDCONFIG_NORMALMODE) && lpSoundDeviceConfig->lpdsPlaybackDevice )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Cannot specify normal mode AND specify dsound object" );
		return DVERR_INVALIDPARAM;
	}

	if( lpSoundDeviceConfig->lpdsPlaybackDevice != NULL)
	{
		if (!DNVALID_READPTR(lpSoundDeviceConfig->lpdsPlaybackDevice, sizeof(IDirectSound)))
		{
			DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid playback device object" );	
			return DVERR_INVALIDPARAM;
		}
	}

	if( lpSoundDeviceConfig->lpdsCaptureDevice != NULL)
	{
		if (!DNVALID_READPTR(lpSoundDeviceConfig->lpdsCaptureDevice, sizeof(IDirectSoundCapture)))
		{
			DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid capture device object" );	
			return DVERR_INVALIDPARAM;
		}
	}

	if (!IsWindow(lpSoundDeviceConfig->hwndAppWindow))
	{
		DPFX(DPFPREP, DVF_ERRORLEVEL, "Invalid window handle");
		return DVERR_INVALIDPARAM;
	}

	hr = DV_ValidBufferSettings( lpSoundDeviceConfig->lpdsMainBuffer, 
							  lpSoundDeviceConfig->dwMainBufferPriority,
							  lpSoundDeviceConfig->dwMainBufferFlags, pwfxPlayFormat );

	if( FAILED( hr ) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid buffer or buffer settings specified in sound config hr=0x%x", hr );
		return hr;
	}

	return DV_OK;
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_ValidClientConfig"
// DV_ValidClientConfig
//
// Checks the valid client configuration structure to ensure it's valid
//
HRESULT DV_ValidClientConfig( LPDVCLIENTCONFIG lpClientConfig )
{
	if( lpClientConfig == NULL || !DNVALID_READPTR(lpClientConfig,sizeof(DVCLIENTCONFIG)) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid pointer" );
		return E_POINTER;
	}

	if( lpClientConfig->dwSize != sizeof( DVCLIENTCONFIG ) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid size" );
		return DVERR_INVALIDPARAM;
	}

	if( lpClientConfig->dwFlags & 
	    ~(DVCLIENTCONFIG_RECORDMUTE | DVCLIENTCONFIG_PLAYBACKMUTE | 
	      DVCLIENTCONFIG_AUTOVOICEACTIVATED | DVCLIENTCONFIG_AUTORECORDVOLUME | 
	      DVCLIENTCONFIG_MUTEGLOBAL | DVCLIENTCONFIG_MANUALVOICEACTIVATED |
		  DVCLIENTCONFIG_AUTOVOLUMERESET | DVCLIENTCONFIG_ECHOSUPPRESSION ) 
	  )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid flags" );
		return DVERR_INVALIDFLAGS;
	}

	if( lpClientConfig->dwFlags & DVCLIENTCONFIG_MANUALVOICEACTIVATED && 
	   lpClientConfig->dwFlags & DVCLIENTCONFIG_AUTOVOICEACTIVATED )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Cannot specify manual AND auto voice activated" );
		return DVERR_INVALIDFLAGS;
	}

    if( lpClientConfig->dwFlags & DVCLIENTCONFIG_AUTORECORDVOLUME ) 
	{
        if( !DV_ValidRecordVolume(lpClientConfig->lRecordVolume) 
	    	&& lpClientConfig->lRecordVolume != DVRECORDVOLUME_LAST )
	    {
	    	DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid record volume w/auto" );
			return DVERR_INVALIDPARAM;
		}
	}
	else
	{
		if( !DV_ValidRecordVolume( lpClientConfig->lRecordVolume ) )
		{
			DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid recording volume" );
			return DVERR_INVALIDPARAM;
		}
	}

	if(	!DV_ValidPlaybackVolume( lpClientConfig->lPlaybackVolume ) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid playback volume" );
		return DVERR_INVALIDPARAM;
	}

	// If it's NOT manual, this parameter must be 0.
	if( !(lpClientConfig->dwFlags & DVCLIENTCONFIG_MANUALVOICEACTIVATED) )
	{
		if( lpClientConfig->dwThreshold != DVTHRESHOLD_UNUSED )
		{
			DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid sensitivity w/auto" );
			return DVERR_INVALIDPARAM;
		}
	}
	else
	{
		if( !DV_ValidSensitivity( lpClientConfig->dwThreshold ) )
		{
			DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid sensitivity" );
			return DVERR_INVALIDPARAM;
		}
	}

	if( !DV_ValidBufferAggresiveness( lpClientConfig->dwBufferAggressiveness ) ||
		!DV_ValidBufferQuality( lpClientConfig->dwBufferQuality ) || 
		!DV_ValidNotifyPeriod( lpClientConfig->dwNotifyPeriod ) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid volume/aggresiveness/period" );
		return DVERR_INVALIDPARAM;
	}

	return DV_OK;
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_ValidSessionDesc"
// DV_ValidSessionDesc
//
// Checks the specified session description to ensure it's valid.
//
HRESULT DV_ValidSessionDesc( LPDVSESSIONDESC lpSessionDesc )
{
	if( lpSessionDesc == NULL ||
		!DNVALID_READPTR( lpSessionDesc, sizeof(DVSESSIONDESC) ) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid pointer" );				
		return E_POINTER;
	}

	if( lpSessionDesc->dwSize != sizeof( DVSESSIONDESC) ) 
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid size" );			
		return DVERR_INVALIDPARAM;
	}

	if( !DV_ValidBufferAggresiveness( lpSessionDesc->dwBufferAggressiveness ) ||
		!DV_ValidBufferQuality( lpSessionDesc->dwBufferQuality ) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid buffer settings" );		
		return DVERR_INVALIDPARAM;
	}

	if( lpSessionDesc->dwSessionType != DVSESSIONTYPE_PEER &&
	    lpSessionDesc->dwSessionType != DVSESSIONTYPE_MIXING &&
	    lpSessionDesc->dwSessionType != DVSESSIONTYPE_FORWARDING &&
	    lpSessionDesc->dwSessionType != DVSESSIONTYPE_ECHO )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid session type" );	
		return DVERR_INVALIDPARAM;
	}

	if( lpSessionDesc->dwFlags & ~(DVSESSION_SERVERCONTROLTARGET | DVSESSION_NOHOSTMIGRATION) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid flags" );
		return DVERR_INVALIDFLAGS;
	}

	return DV_OK;

}

// DV_ValidBufferAggresiveness
//
// Checks the specified aggressiveness to ensure it's valid
//
BOOL DV_ValidBufferAggresiveness( DWORD dwValue )
{
	if( dwValue != DVBUFFERAGGRESSIVENESS_DEFAULT &&
	    ((dwValue < DVBUFFERAGGRESSIVENESS_MIN) ||
	      dwValue > DVBUFFERAGGRESSIVENESS_MAX) )
	{
		return FALSE;
	}
	else
	{
		return TRUE;
	}
}

// DV_ValidBufferQuality
//
// Checks the specified buffer quality to ensure it's valid
// 
BOOL DV_ValidBufferQuality( DWORD dwValue )
{
	if( dwValue != DVBUFFERQUALITY_DEFAULT &&
	    ((dwValue < DVBUFFERQUALITY_MIN) ||
	      dwValue > DVBUFFERQUALITY_MAX) )
	{
		return FALSE;
	}		
	else
	{
		return TRUE;
	}
}

// DV_ValidSensitivity
//
// Checks the sensitivity to ensure it's valid
//
BOOL DV_ValidSensitivity( DWORD dwValue )
{
	if( dwValue != DVTHRESHOLD_DEFAULT &&
	    (// Commented out because min is currently 0 (dwValue < DVTHRESHOLD_MIN) || 
	     (dwValue > DVTHRESHOLD_MAX) ) )
	{
		return FALSE;
	}
	else
	{
		return TRUE;
	}
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_CopySessionDescToBuffer"
//
// DV_CopySessionDescToBuffer
//
// Checks the parameters for validity and then copies the specified session description
// to the specified buffer.  (If it will fit).
//
HRESULT DV_CopySessionDescToBuffer( LPVOID lpTarget, LPDVSESSIONDESC lpdvSessionDesc, LPDWORD lpdwSize )
{ 
	const DVSESSIONDESC* lpSessionDesc = (LPDVSESSIONDESC) lpTarget;

	if( lpdwSize == NULL ||
	    !DNVALID_READPTR( lpdwSize, sizeof(DWORD) ))
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid pointer" );
		return E_POINTER;
	}

	if( (*lpdwSize) < sizeof( DVSESSIONDESC ) )
	{
		*lpdwSize = sizeof( DVSESSIONDESC );	

		DPFX(DPFPREP,   DVF_INFOLEVEL, "Error size" );
		return DVERR_BUFFERTOOSMALL;
	}

	*lpdwSize = sizeof( DVSESSIONDESC );	

	if( lpTarget == NULL || !DNVALID_WRITEPTR(lpTarget,sizeof( DVSESSIONDESC )) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Target buffer pointer bad" );
		return E_POINTER;
	}

	memcpy( lpTarget, lpdvSessionDesc, sizeof( DVSESSIONDESC ) ); 

	DPFX(DPFPREP,   DVF_ENTRYLEVEL, "DVCE::GetSessionDesc() Success" );

	return DV_OK;
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_GetWaveFormatExSize"
DWORD DV_GetWaveFormatExSize( const WAVEFORMATEX* lpwfxFormat )
{
	DNASSERT( lpwfxFormat != NULL );

	return (lpwfxFormat->cbSize+sizeof(WAVEFORMATEX));
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_AddRef"
STDAPI DV_AddRef(LPDIRECTVOICEOBJECT lpDV )
{
	LONG rc;

	DNEnterCriticalSection( &lpDV->csCountLock );
	
	rc = ++lpDV->lIntRefCnt;

	DNLeaveCriticalSection( &lpDV->csCountLock );

	return rc;
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_Initialize"
//
// DV_Initialize
//
// Responsible for initializing the specified directvoice object with the specified parameters.
//
STDAPI DV_Initialize( LPDIRECTVOICEOBJECT lpdvObject, LPUNKNOWN lpTransport, LPDVMESSAGEHANDLER lpMessageHandler, LPVOID lpUserContext, LPDWORD lpdwMessages, DWORD dwNumElements )
{
	HRESULT hr = S_OK;

	LPUNKNOWN lpUnknown = lpTransport;
	LPDIRECTPLAYVOICETRANSPORT lpdvNotify;
	CDirectVoiceDirectXTransport *lpdxTransport;

	if( lpUnknown == NULL )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Bad pointer" );
		return DVERR_NOTRANSPORT;
	}

	// Fix a memory leak if you Connect/Disconnect and then reconnect.  
	if( lpdvObject->lpDVTransport )
	{
		delete lpdvObject->lpDVTransport;
		lpdvObject->lpDVTransport = NULL;
	}

	// Try and retrieve transport interface from the object we got.
	hr = lpUnknown->QueryInterface( IID_IDirectPlayVoiceTransport, (void **) &lpdvNotify );

	// If we failed, default to the old type
	if( FAILED( hr ) )
	{
		if( hr == E_NOINTERFACE )
		{
			DPFX(DPFPREP,  DVF_ERRORLEVEL, "The specified interface is not a valid transport" );
			return DVERR_NOTRANSPORT;
		}
		else
		{
			DPFX(DPFPREP,  DVF_ERRORLEVEL, "Query for interface failed hr = 0x%x", hr );
			return DVERR_GENERIC;
		}
	}
	// Otherwise, startup the new transport system.  
	else
	{
		lpdxTransport = new CDirectVoiceDirectXTransport(lpdvNotify);

		if( lpdxTransport == NULL )
		{
			DPFX(DPFPREP,  DVF_ERRORLEVEL, "Unable to allocate transport" );
			lpdvNotify->Release();
			return DVERR_OUTOFMEMORY;
		}
		
		lpdvNotify->Release();
	}

	hr = lpdvObject->lpDVEngine->Initialize( static_cast<CDirectVoiceTransport *>(lpdxTransport), lpMessageHandler, lpUserContext, lpdwMessages, dwNumElements  );

	if( FAILED( hr ) )
	{
		delete lpdxTransport;

		return hr;
	}

	lpdvObject->lpDVTransport = static_cast<CDirectVoiceTransport *>(lpdxTransport);

	return S_OK;
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_DUMP_Caps"
// DV_DUMP_Caps
//
// Dumps a DVCAPS structure
//
void DV_DUMP_Caps( LPDVCAPS lpdvCaps )
{
	DNASSERT( lpdvCaps != NULL );

	// 7/31/2000(a-JiTay): IA64: Use %p format specifier for 32/64-bit pointers, addresses, and handles.
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "DVCAPS Dump Addr=0x%p", lpdvCaps );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwSize = %d", lpdvCaps->dwSize );		
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwFlags = 0x%x", lpdvCaps->dwFlags );
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_DUMP_GUID"
void DV_DUMP_GUID( const GUID& guid )
{
    DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "{%-08.8X-%-04.4X-%-04.4X-%02.2X%02.2X-%02.2X%02.2X%02.2X%02.2X%02.2X%02.2X}", guid.Data1, guid.Data2, guid.Data3, 
               guid.Data4[0], guid.Data4[1], guid.Data4[2], guid.Data4[3],
               guid.Data4[4], guid.Data4[5], guid.Data4[6], guid.Data4[7] );
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_DUMP_CompressionInfo"
void DV_DUMP_CompressionInfo( LPDVCOMPRESSIONINFO lpdvCompressionInfo, DWORD dwNumElements )
{
	DNASSERT( lpdvCompressionInfo != NULL );

	DWORD dwIndex;

	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "DVCOMPRESSIONINFO Array Dump Addr=0x%p", lpdvCompressionInfo );

	for( dwIndex = 0; dwIndex < dwNumElements; dwIndex++ )
	{
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwSize = %d", lpdvCompressionInfo[dwIndex].dwSize );		
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwFlags = 0x%x", lpdvCompressionInfo[dwIndex].dwFlags );		
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "lpszDescription = %ls", lpdvCompressionInfo[dwIndex].lpszDescription );		
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "lpszName = %ls", lpdvCompressionInfo[dwIndex].lpszName );		
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "guidType = " );
		DV_DUMP_GUID( lpdvCompressionInfo[dwIndex].guidType );
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwMaxBitsPerSecond = %d", lpdvCompressionInfo[dwIndex].dwMaxBitsPerSecond );
	}
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_DUMP_FullCompressionInfo"
void DV_DUMP_FullCompressionInfo( LPDVFULLCOMPRESSIONINFO lpdvfCompressionInfo, DWORD dwNumElements )
{
	DNASSERT( lpdvfCompressionInfo != NULL );

	DWORD dwIndex;

	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "DVFULLCOMPRESSIONINFO Array Dump Addr=0x%p", lpdvfCompressionInfo );

	for( dwIndex = 0; dwIndex < dwNumElements; dwIndex++ )
	{
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwSize = %d", lpdvfCompressionInfo[dwIndex].dwSize );		
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwFlags = 0x%x", lpdvfCompressionInfo[dwIndex].dwFlags );		
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "lpszDescription = %ls", lpdvfCompressionInfo[dwIndex].lpszDescription );		
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "lpszName = %ls", lpdvfCompressionInfo[dwIndex].lpszName );		
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "guidType = " );
		DV_DUMP_GUID( lpdvfCompressionInfo[dwIndex].guidType );
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "lpwfxFormat = 0x%p", lpdvfCompressionInfo[dwIndex].lpwfxFormat );
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwFramesPerBuffer = %d", lpdvfCompressionInfo[dwIndex].dwFramesPerBuffer );
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwTrailFrames = %d", lpdvfCompressionInfo[dwIndex].dwTrailFrames );
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwTimeout = %d", lpdvfCompressionInfo[dwIndex].dwTimeout );			
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "bMinConnectType = %d", (DWORD) lpdvfCompressionInfo[dwIndex].bMinConnectType );
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwFrameLength = %d", lpdvfCompressionInfo[dwIndex].dwFrameLength );		 
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwFrame8Khz = %d", lpdvfCompressionInfo[dwIndex].dwFrame8Khz );		  
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwFrame11Khz = %d", lpdvfCompressionInfo[dwIndex].dwFrame11Khz );		
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwFrame22Khz = %d", lpdvfCompressionInfo[dwIndex].dwFrame22Khz );		 
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwFrame44Khz = %d", lpdvfCompressionInfo[dwIndex].dwFrame44Khz );		
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwMaxBitsPerSecond = %d", lpdvfCompressionInfo[dwIndex].dwMaxBitsPerSecond );	
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "wInnerQueueSize = %d", lpdvfCompressionInfo[dwIndex].wInnerQueueSize );	
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "wMaxHighWaterMark = %d", lpdvfCompressionInfo[dwIndex].wMaxHighWaterMark );
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "bMaxQueueSize = %d", (DWORD) lpdvfCompressionInfo[dwIndex].bMaxQueueSize );
	}
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_DUMP_SessionDesc"
void DV_DUMP_SessionDesc( LPDVSESSIONDESC lpdvSessionDesc )
{
	DNASSERT( lpdvSessionDesc != NULL );

	// 7/31/2000(a-JiTay): IA64: Use %p format specifier for 32/64-bit pointers, addresses, and handles.
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "DVSESSIONDESC Dump Addr=0x%p", lpdvSessionDesc );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwSize = %d", lpdvSessionDesc->dwSize );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwFlags = 0x%x", lpdvSessionDesc->dwFlags );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "          %s", (lpdvSessionDesc->dwFlags & DVSESSION_SERVERCONTROLTARGET) ? _T("DVSESSION_SERVERCONTROLTARGET,") : _T(""));

	switch( lpdvSessionDesc->dwSessionType )
	{
	case DVSESSIONTYPE_PEER:
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwSessionType = DVSESSIONTYPE_PEER" );
		break;
	case DVSESSIONTYPE_MIXING:
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwSessionType = DVSESSIONTYPE_MIXING" );
		break;
	case DVSESSIONTYPE_FORWARDING: 
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwSessionType = DVSESSIONTYPE_FORWARDING" );
		break;
	case DVSESSIONTYPE_ECHO: 
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwSessionType = DVSESSIONTYPE_ECHO" );
		break;
	default:
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwSessionType = Unknown" );
		break;
	}

	if( lpdvSessionDesc->dwBufferAggressiveness == DVBUFFERAGGRESSIVENESS_DEFAULT )
	{
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwBufferAggressiveness = DEFAULT" );
	}
	else
	{
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwBufferAggressiveness = %d", lpdvSessionDesc->dwBufferAggressiveness );
	}

	if( lpdvSessionDesc->dwBufferQuality == DVBUFFERQUALITY_DEFAULT )
	{
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwBufferQuality = DEFAULT" );
	}
	else
	{
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwBufferQuality = %d", lpdvSessionDesc->dwBufferQuality );
	}

	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "guidCT = " );
	DV_DUMP_GUID( lpdvSessionDesc->guidCT );

}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_DUMP_DSBDESC"
void DV_DUMP_DSBDESC( LPDSBUFFERDESC lpdsBufferDesc )
{
	// 7/31/2000(a-JiTay): IA64: Use %p format specifier for 32/64-bit pointers, addresses, and handles.
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "DSBUFFERDESC DUMP Addr=0x%p", lpdsBufferDesc );

	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwSize = %d", lpdsBufferDesc->dwSize );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwFlags = 0x%x", lpdsBufferDesc->dwFlags );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwBufferBytes = %d", lpdsBufferDesc->dwBufferBytes );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwReserved = %d", lpdsBufferDesc->dwReserved );

	if( lpdsBufferDesc->dwSize >= sizeof( DSBUFFERDESC1 ) )
	{
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "guid3DAlgorithm = " );
		DV_DUMP_GUID( lpdsBufferDesc->guid3DAlgorithm );
	}

	if( lpdsBufferDesc->lpwfxFormat == NULL )
	{
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "lpwfxFormat = NULL" );
	}
	else
	{
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "lpwfxFormat = " );	
		DV_DUMP_WaveFormatEx(lpdsBufferDesc->lpwfxFormat);
	}
	
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_DUMP_SoundDeviceConfig"
void DV_DUMP_SoundDeviceConfig( LPDVSOUNDDEVICECONFIG lpdvSoundConfig )
{
	DNASSERT( lpdvSoundConfig != NULL );

	// 7/31/2000(a-JiTay): IA64: Use %p format specifier for 32/64-bit pointers, addresses, and handles.
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "DVSOUNDDEVICECONFIG Dump Addr=0x%p", lpdvSoundConfig );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwSize = %d", lpdvSoundConfig->dwSize );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwFlags = 0x%x", lpdvSoundConfig->dwFlags );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "          %s%s%s%s", 
							(lpdvSoundConfig->dwFlags & DVSOUNDCONFIG_AUTOSELECT) ? _T("DVSOUNDCONFIG_AUTOSELECT,") : _T(""),
							(lpdvSoundConfig->dwFlags & DVSOUNDCONFIG_HALFDUPLEX) ? _T("DVSESSION_HALFDUPLEX,") : _T(""), 
							(lpdvSoundConfig->dwFlags & DVSOUNDCONFIG_STRICTFOCUS) ? _T("DVSOUNDCONFIG_STRICTFOCUS,") : _T(""),
							(lpdvSoundConfig->dwFlags & DVSOUNDCONFIG_NOFOCUS) ? _T("DVSOUNDCONFIG_NOFOCUS,") : _T(""));

	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "guidPlaybackDevice =" );
	DV_DUMP_GUID( lpdvSoundConfig->guidPlaybackDevice );

	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "guidCaptureDevice =" );
	DV_DUMP_GUID( lpdvSoundConfig->guidCaptureDevice );

	// 7/31/2000(a-JiTay): IA64: Use %p format specifier for 32/64-bit pointers, addresses, and handles.
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "lpdsPlaybackDevice = 0x%p", lpdvSoundConfig->lpdsPlaybackDevice ) ;
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "lpdsCaptureDevice = 0x%p", lpdvSoundConfig->lpdsCaptureDevice ) ;
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "lpdsMainBuffer = 0x%p", lpdvSoundConfig->lpdsMainBuffer );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwMainBufferPriority = 0x%x", lpdvSoundConfig->dwMainBufferPriority );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwMainBufferFlags = 0x%x", lpdvSoundConfig->dwMainBufferFlags );

}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_DUMP_ClientConfig"
void DV_DUMP_ClientConfig( LPDVCLIENTCONFIG lpdvClientConfig )
{
	DNASSERT( lpdvClientConfig != NULL );

	// 7/31/2000(a-JiTay): IA64: Use %p format specifier for 32/64-bit pointers, addresses, and handles.
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "DVCLIENTCONFIG Dump Addr = 0x%p", lpdvClientConfig );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwSize = %d", lpdvClientConfig->dwSize );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwFlags = 0x%x", lpdvClientConfig->dwFlags );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "          %s%s%s%s%s%s", 
							(lpdvClientConfig->dwFlags & DVCLIENTCONFIG_RECORDMUTE) ? _T("DVCLIENTCONFIG_RECORDMUTE,") : _T(""), 
							(lpdvClientConfig->dwFlags & DVCLIENTCONFIG_PLAYBACKMUTE) ? _T("DVCLIENTCONFIG_PLAYBACKMUTE,") : _T(""),
							(lpdvClientConfig->dwFlags & DVCLIENTCONFIG_MANUALVOICEACTIVATED) ? _T("DVCLIENTCONFIG_MANUALVOICEACTIVATED,") : _T(""), 
							(lpdvClientConfig->dwFlags & DVCLIENTCONFIG_AUTOVOICEACTIVATED) ? _T("DVCLIENTCONFIG_AUTOVOICEACTIVATED,") : _T(""),
							(lpdvClientConfig->dwFlags & DVCLIENTCONFIG_MUTEGLOBAL) ? _T("DVCLIENTCONFIG_MUTEGLOBAL,") : _T(""), 
							(lpdvClientConfig->dwFlags & DVCLIENTCONFIG_AUTORECORDVOLUME) ? _T("DVCLIENTCONFIG_AUTORECORDVOLUME") : _T("") );

	if( lpdvClientConfig->dwBufferAggressiveness == DVBUFFERAGGRESSIVENESS_DEFAULT )
	{
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwBufferAggressiveness = DEFAULT" );
	}
	else
	{
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwBufferAggressiveness = %d", lpdvClientConfig->dwBufferAggressiveness );
	}

	if( lpdvClientConfig->dwBufferQuality == DVBUFFERQUALITY_DEFAULT )
	{
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwBufferQuality = DEFAULT" );
	}
	else
	{
		DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwBufferQuality = %d", lpdvClientConfig->dwBufferQuality );
	}

	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "dwNotifyPeriod = %d", lpdvClientConfig->dwNotifyPeriod );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "lPlaybackVolume = %li", lpdvClientConfig->lPlaybackVolume );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "lRecordVolume = %li", lpdvClientConfig->lRecordVolume );
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_DUMP_WaveFormatEx"
void DV_DUMP_WaveFormatEx( LPWAVEFORMATEX lpwfxFormat )
{
	DNASSERT( lpwfxFormat != NULL );

	// 7/31/2000(a-JiTay): IA64: Use %p format specifier for 32/64-bit pointers, addresses, and handles.
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "WAVEFORMATEX Dump Addr = 0x%p", lpwfxFormat );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "wFormatTag = %d", lpwfxFormat->wFormatTag );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "nSamplesPerSec = %d", lpwfxFormat->nSamplesPerSec );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "nChannels = %d", lpwfxFormat->nChannels );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "wBitsPerSample = %d", lpwfxFormat->wBitsPerSample );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "nAvgBytesPerSec = %d", lpwfxFormat->nAvgBytesPerSec );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "nBlockAlign = %d", lpwfxFormat->nBlockAlign );
	DPFX(DPFPREP,  DVF_STRUCTUREDUMP, "cbSize = %d", lpwfxFormat->cbSize );
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_ValidDirectVoiceObject"
// DV_ValidDirectVoiceObject
//
// Checks to ensure the specified pointer points to a valid directvoice 
// object.
BOOL DV_ValidDirectVoiceObject( LPDIRECTVOICEOBJECT lpdv )
{
	if( lpdv == NULL )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Object is null" );
		return FALSE;
	}

	if( !DNVALID_READPTR( lpdv, sizeof( DIRECTVOICEOBJECT ) ) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid read ptr" );
		return FALSE;
	}

	if( lpdv->lpDVEngine != NULL &&
	    !DNVALID_READPTR( lpdv->lpDVEngine, sizeof( CDirectVoiceEngine ) ) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid engine" );
		return FALSE;
	}

	if( lpdv->lpDVTransport != NULL &&
		!DNVALID_READPTR( lpdv->lpDVEngine, sizeof( CDirectVoiceTransport ) ) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid transport" );
		return FALSE;
	}

	return TRUE;
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_ValidDirectXVoiceClientObject"
// DV_ValidDirectXVoiceClientObject
//
// Checks to ensure the specified pointer points to a valid directvoice 
// object.
BOOL DV_ValidDirectXVoiceClientObject( LPDIRECTVOICEOBJECT lpdvc )
{
	if( !DV_ValidDirectVoiceObject( lpdvc ) )
	{
		return FALSE;
	}

	if( lpdvc->lpVtbl != dvcInterface )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Bad vtable" );
		return FALSE;
	}

	if( lpdvc->dvNotify.lpNotifyVtble != NULL && 
	    lpdvc->dvNotify.lpNotifyVtble != dvClientNotifyInterface )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid notify vtable" );
		return FALSE;
	}

	LPDIRECTVOICECLIENTOBJECT lpdvClientObject = (LPDIRECTVOICECLIENTOBJECT) lpdvc;

	if( lpdvClientObject->lpDVClientEngine != NULL && 
	    !DNVALID_READPTR( lpdvClientObject->lpDVClientEngine, sizeof( CDirectVoiceClientEngine ) ) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid client engine" );
		return FALSE;
	}
	
	return TRUE;
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_ValidDirectXVoiceServerObject"
// DV_ValidDirectXVoiceServerObject
//
// Checks to ensure the specified pointer points to a valid directvoice 
// object.
BOOL DV_ValidDirectXVoiceServerObject( LPDIRECTVOICEOBJECT lpdvs )
{
	if( !DV_ValidDirectVoiceObject( lpdvs ) )
	{
		return FALSE;
	}

	if( lpdvs->lpVtbl != dvsInterface )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid server vtable" );	
		return FALSE;
	}

	if( lpdvs->dvNotify.lpNotifyVtble != NULL && 
	    lpdvs->dvNotify.lpNotifyVtble != dvServerNotifyInterface )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid notify vtable" );		
		return FALSE;
	}

	LPDIRECTVOICESERVEROBJECT lpdvServerObject = (LPDIRECTVOICESERVEROBJECT) lpdvs;

	if( lpdvServerObject->lpDVServerEngine != NULL && 
	    !DNVALID_READPTR( lpdvServerObject->lpDVServerEngine, sizeof( CDirectVoiceServerEngine ) ) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid server engine" );	
		return FALSE;
	}	

	return TRUE;
}

#undef DPF_MODNAME
#define DPF_MODNAME "DV_ValidMessageArray"
// Validate message mask.
//
// May be too strict to enforce server only or client/only.
//
HRESULT DV_ValidMessageArray( const DWORD* lpdwMessages, DWORD dwNumMessages, BOOL fServer )
{
	if( dwNumMessages > 0 &&
	    (lpdwMessages == NULL || 
	     !DNVALID_READPTR( lpdwMessages, sizeof(DWORD)*dwNumMessages )) )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid pointer passed for the lpdwMessages parameter." );
		return DVERR_INVALIDPOINTER;
	}

	if( lpdwMessages != NULL && dwNumMessages == 0 )
	{
		DPFX(DPFPREP,  DVF_ERRORLEVEL, "Non-NULL notification array with 0 size" );
		return DVERR_INVALIDPARAM;
	}

	DWORD dwIndex, dwSubIndex;

	for( dwIndex = 0; dwIndex < dwNumMessages; dwIndex++ )
	{
		if( lpdwMessages[dwIndex] < DVMSGID_MINBASE || lpdwMessages[dwIndex] > DVMSGID_MAXBASE )
		{
			DPFX(DPFPREP,  DVF_ERRORLEVEL, "Invalid message specified in notification array" );
			return DVERR_INVALIDPARAM;
		}
			
		switch( lpdwMessages[dwIndex] )
		{
		// Player only messages
		case DVMSGID_PLAYERVOICESTART:
		case DVMSGID_PLAYERVOICESTOP:
		case DVMSGID_RECORDSTART:
		case DVMSGID_RECORDSTOP:
		case DVMSGID_CONNECTRESULT:
		case DVMSGID_DISCONNECTRESULT:
		case DVMSGID_INPUTLEVEL:
		case DVMSGID_OUTPUTLEVEL:
		case DVMSGID_SETTARGETS:
		case DVMSGID_PLAYEROUTPUTLEVEL:
		case DVMSGID_LOSTFOCUS:
		case DVMSGID_GAINFOCUS:		
		case DVMSGID_HOSTMIGRATED:
		case DVMSGID_LOCALHOSTSETUP:
			if( fServer )
			{
				DPFX(DPFPREP,  0, "Client-only notification ID specified in server notification mask" );
				return DVERR_INVALIDPARAM;
			}
			break;
		}

		for( dwSubIndex = 0; dwSubIndex < dwNumMessages; dwSubIndex++ )
		{	
			if( dwIndex != dwSubIndex && 
			    lpdwMessages[dwIndex] == lpdwMessages[dwSubIndex] ) 
			{
				DPFX(DPFPREP,  0, "Duplicate IDs specified in notification mask" );
				return DVERR_INVALIDPARAM;
			}
		}
	}

	return TRUE;
}