Developing MIDI applications with DirectMusic

/*
 ____   _  ____  _____ _____ ______  __  __  _  ____   _
|  _ \ | ||  _ \|  __//  __//_   _/ |  \/  || ||  _ \ | |
| |_| || || |> /|  _| | <__   | |   | |\/| || || |_| || | 
|____/ |_||_|\_\|____\\____/  |_|   |_|  |_||_||____/ |_|			 

////////////////////////////////////////////////////////////////////////
  
  This library is free software; you can redistribute it and/or
  modify it under the terms of the GNU Lesser General Public
  License as published by the Free Software Foundation; either
  version 2.1 of the License, or (at your option) any later version.
 
  This library is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  Lesser General Public License for more details.
 
  You should have received a copy of the GNU Lesser General Public
  License along with this library; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
 
Copyright (c) 2002-2003 by Carlos Jim�nez de Parga  
All rights reserved.
For any suggestion or failure report, please contact me by:
e-mail: cjimenez@isometrica.net
  
Note: I would appreciate very much if you could provide a brief description of your project, 
as well as any report on bugs or errors. This will help me improve the code for the benefit of your
application and the other users  
///////////////////////////////////////////////////////////////////////
Version: 2.2b
Module : CInstrument.cpp
Purpose: Code implementation for CInstrument class
Created: CJP / 02-08-2002
History: CJP / 03-10-2003 
Date format: Day-month-year
	
	Update: 20/09/2002

	1. Improved class destructors

	2. Check member variables for NULL values before performing an operation
		
	3. Restructured the class system
	
	4. Better method to enumerate and select MIDI ports
	
	5. Adapted the external thread to a pure virtual function

	6. SysEx reception and sending enabled

	7. Added flexible conversion functions

	8. Find out how to activate the Microsoft software synth. 

	9. Added DLS support

  Update: 25/03/2003

	10. Added exception handling

    11. Fixed bugs with channel groups
  
    12. Redesigned class hierarchy
	
    13. DirectMidi wrapped in the directmidi namespace
  
    14. UNICODE/MBCS support for instruments and ports

	15. Added DELAY effect to software synthesizer ports
	
	16. Project released under GNU (General Public License) terms		 

  Update: 03/10/2003	

	17. Redesigned class interfaces

	18. Safer input port termination thread

	19. New CMasterClock class

	20. DLS files can be loaded from resources

	21. DLS instruments note range support

	22. New CSampleInstrument class added to the library

	23. Direct download of samples to wave-table memory
	
	24. .WAV file sample format supported	

	25. New methods added to the output port class

	26. Fixed small bugs

*/

#include "CDirectMidi.h"

using namespace directmidi;


// Class constructor, initializes member variables

CInstrument::CInstrument()
{
	m_pDownLoadedInstrument = NULL;
	m_pInstrument			= NULL;
	m_pPort					= NULL;
	m_dwPatchInCollection	= 0;
	m_dwPatchInMidi			= 0;
	m_strInstName[0]		= '\0';
}


// Sets the destination of the instrument in a synthesizer MIDI program 

HRESULT CInstrument::SetPatch(DWORD dwdstPatchMidi)
{
	HRESULT hr = DM_FAILED;
	TCHAR strMembrFunc [] = _T("CInstrument::SetPach()");
	if (m_pInstrument)
	{	
		if (FAILED(hr = m_pInstrument->SetPatch(dwdstPatchMidi))) 
			throw CDMusicException(strMembrFunc,hr,__LINE__);
		m_dwPatchInMidi = dwdstPatchMidi;
	} else throw CDMusicException(strMembrFunc,hr,__LINE__);
	
	return S_OK;
}	

// Returns the note range

void CInstrument::GetNoteRange(LPDWORD pdwLowNote,LPDWORD pdwHighNote)
{
	*pdwLowNote = m_NoteRange.dwLowNote;
	*pdwHighNote = m_NoteRange.dwHighNote;
}

// Sets the note range

void CInstrument::SetNoteRange(DWORD dwLowNote,DWORD dwHighNote)
{
	m_NoteRange.dwLowNote  = dwLowNote;
	m_NoteRange.dwHighNote = dwHighNote;
}

// Class destructor

CInstrument::~CInstrument()
{
	// Release the reference to the interface that contains information about
	// the downloaded instrument
	// Unloads the instrument from the port memory
	if ((m_pPort) && (m_pDownLoadedInstrument))
		m_pPort->UnloadInstrument(m_pDownLoadedInstrument); 
	SAFE_RELEASE(m_pDownLoadedInstrument); 
	SAFE_RELEASE(m_pInstrument);
}