Source code of Windows XP (NT5)
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
|
<HTML><HEAD><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252"><META NAME="Generator" CONTENT="Microsoft Word 97"><TITLE>DirectMusic</TITLE><META NAME="Template" CONTENT="C:\PROGRAM FILES\MICROSOFT OFFICE\OFFICE\html.dot"></HEAD><BODY TEXT="#000000" LINK="#0000ff" VLINK="#800080" BGCOLOR="#ffffff" leftmargin="8"><FONT FACE="Verdana"><H2><A NAME="MYSAMPLE">DirectMusic Software Synthesizer</A> </H2>
<H3>Summary</H3></FONT><FONT FACE="Verdana" SIZE=2><P>
This sample contains working source code for a user-mode software synthesizer that plugsinto the Microsoft® DirectMusic® architecture.<P>
<H3>Building a new DirectMusic Synthesizer</H3></FONT><FONT FACE="Verdana" SIZE=2><P>You are encouraged to use this sample code to start building your own softwaresynthesizer. Modify the sample to add your own features.<P>
If you ship your synthesizer to customers, be sure to use the Guidgen program to createa Globally Unique ID (GUID) for your synthesizer so it won't interfere with othersynthesizers. Set CLSID_DDKSynth at the top of Umsynth.h to be your GUID. You should alsoset the text in Ddksynth.cpp and Ddksynth.rc to describe your synthesizer.<P>
<H3>Creating a Kernel-mode Synthesizer or Driver</H3></FONT><FONT FACE="Verdana" SIZE=2><P>Although this sample doesn't show you how to create a kernel-mode synthesizer or driver,you can use this code to feel out how synthesis and DLS downloads work. We recommend thatyou try out your ideas and get things working in a user-mode synthesizer before moving tokernel mode or writing drivers. This approach is often easier and can savequite a bit of debugging time.<P>
<H3>Building the Sample</H3></FONT><FONT FACE="Verdana" SIZE=2><P>Open a free or checked DDK build environment, go to this directory, and run <B>build</B>.This creates Ddksynth.dll in the Objfre or Objchk directory. Before the sample canbe used, it must be registered by running <B>regsvr32 ddksynth.dll</B>.<P>
<H3>Testing the Synthesizer</H3></FONT><FONT FACE="Verdana" SIZE=2><P>To test the synthesizer, open DirectMusic Producer and open the Port Configuration window.(You can do this by right-clicking the button showing a 1 or 2 with a sound wave behind it on theTransit Controls toolbar.) The port name dropdown will now contain the option <B>MicrosoftDDK Synthesizer</B> in addition to the Microsoft Synthesizer option. Set one of theconfigurations to use the Microsoft DDK Synthesizer port.<P>
Then, when you play music through that configuration, it will be played by the synthesizeryou built from the DDK sample. The sound and capabilities of the DDK sample (Microsoft DDKSynthesizer) are virtually identical to the default DirectMusic synthesizer(Microsoft Synthesizer), one major exception to this being that the DDK sample synthesizerdoes not support reverb.<P>
<H3>Supported Configurations</H3></FONT><FONT FACE="Verdana" SIZE=2><P>The DDK sample synthesizer has been tested in checked and free builds with Microsoft Visual C++®versions 5 and 6. It has not been tested on Alpha or other 64-bit platforms.<P>
No special Plug and Play or Power Management support is required for this type of synthesizer.<P>
<H3>CODE TOUR</H3><H4>File Manifest</H4></FONT><U><PRE>File		 Description</U>Instr.cpp	 Implements instrumentsUmsynth.cpp	 Implementation of CUserModeSynthUmsynth.h	 Prototype file for Umsynth.cppVoice.cpp	 Implements voicesClist.cpp	 Implements a simple list data structureClist.h 	 Prototype file for Clist.cppControl.cpp	 Implementation of CControlLogicCsynth.cpp	 Implementation of CSynthCsynth.h	 Prototype file for Csynth.hMidi.cpp	 Implements MIDI eventsMix.cpp	 Implements CDigitalAudio mixing functionsMmx.cpp	 Implements MMX-optimized mixing functionsPlclock.cpp	 Implements clocksPlclock.h	 Prototype file for Plclock.cppDdksynth.cpp	 DLL entry points and IDirectMusicSynthFactory implementationOledll.cpp	 Handle standard entry points for OLE server DLLOledll.h	 Prototype file for Oledll.hSynth.h	 Prototype file for Instr.cpp, Midi.cpp, Voice.cpp, and Control.cppSimple.h	 Includes some common header filesMisc.h	 Prototypes of miscellaneous helper functionsValidate.h	 Pointer validation macrosDebug.cpp	 Debugging helper functions such as assertions and tracingDebug.h	 Prototype file for Debug.cppDdksynth.rc	 Resources file containung version informationGuids.cpp	 GUID definitionsDdksynth.def	 DLL .def fileMakefile	 Makefile for BUILD environmentSources	 Sources file for BUILD environment
</FONT><P ALIGN="CENTER"><A HREF="#top"><FONT FACE="Verdana" SIZE=2>Top of page</FONT></A><FONT FACE="Verdana" SIZE=2> </P></FONT><TABLE CELLSPACING=0 BORDER=0 WIDTH=624><TR><TD VALIGN="MIDDLE" BGCOLOR="#00ffff" HEIGHT=2><P></TD></TR></TABLE>
<FONT FACE="MS Sans Serif" SIZE=1><P>© 1999 Microsoft Corporation</FONT><FONT FACE="Verdana" SIZE=2> </P></FONT></BODY></HTML>
|
