updated Windows+ASIO build tutorial: Building Portaudio for Windows with ASIO support using MSVC. The tutorial was out of date and contained a number of errors that broke the build process.

doc/src/tutorial/compile_windows_asio_msvc.dox

diff --git a/doc/src/tutorial/compile_windows_asio_msvc.dox b/doc/src/tutorial/compile_windows_asio_msvc.dox
index 98ff2e3..b4c2ab0 100644
--- a/doc/src/tutorial/compile_windows_asio_msvc.dox
+++ b/doc/src/tutorial/compile_windows_asio_msvc.dox
@@ -7,14 +7,14 @@
 

 ASIO is a low latency audio API from Steinberg. To compile an ASIO

 application, you must first download the ASIO SDK from Steinberg. You also

-need to obtain ASIO drivers for your audio device. Download the ASIO SDK from Steinberg at http://www.steinberg.net/en/company/developer.html. The SDK is free but you will need to set up a developer account with Steinberg.

+need to obtain ASIO drivers for your audio device. Download the ASIO SDK from Steinberg at http://www.steinberg.net/en/company/developer.html . The SDK is free but you will need to set up a developer account with Steinberg.

 

 This tutorial assumes that you have 3 directories set up at the same level (side by side), one containing PortAudio, one containing the ASIO SDK and one containing your Visual Studio project:

 

 @code

 /ASIOSDK2 

 /portaudio

-/DirContainingYourVisualStudioProject

+/DirContainingYourVisualStudioProject  (should directly contain the .sln, .vcproj or .vcprojx etc.)

 @endcode

 

 First, make sure that the Steinberg SDK and the portaudio files are "side by side" in the same directory.

@@ -54,10 +54,11 @@
 pa_trace.c                      (portaudio\src\common)

 pa_win_hostapis.c               (portaudio\src\os\win)

 pa_win_util.c                   (portaudio\src\os\win)

+pa_win_coinitialize.c           (portaudio\src\os\win)

 pa_win_waveformat.c             (portaudio\src\os\win)

 pa_x86_plain_converters.c       (portaudio\src\os\win)

-patest_saw.c                    (portaudio\test)  (Or another file containing main() 

-                                                   for the console exe to be built.)

+paex_saw.c                      (portaudio\examples)  (Or another file containing main() 

+                                                      for the console exe to be built.)

 @endcode

 

 

@@ -71,25 +72,26 @@
 These header files define the interfaces to the PortAudio API.

 

 

-Next, go to Project Settings > All Configurations  > C/C++ > Preprocessor > Preprocessor definitions and add

+Next, go to Project Settings > All Configurations > C/C++ > Preprocessor > Preprocessor Definitions and add

 PA_USE_ASIO=1 to any entries that might be there.

 

 eg: WIN32;_CONSOLE;_MBCS   changes to    WIN32;_CONSOLE,_MBCS;PA_USE_ASIO=1

 

-Then, on the same Project Settings tab, go down to Additional include directories: and enter the following relative include paths.

+Then, on the same Project Settings tab, go down to Additional Include Directories (in VS2010 you'll find this setting under C/C++ > General) and enter the following relative include paths:

 

 @code

-..\portaudio\include,..\portaudio\src\common,..\asiosdk2\common,..\asiosdk2\host,..\asiosdk2\host\pc

+..\portaudio\include;..\portaudio\src\common;..\portaudio\src\os\win;..\asiosdk2\common;..\asiosdk2\host;..\asiosdk2\host\pc

 @endcode

 

 You'll need to make sure the relative paths are correct for the particular directory layout you're using. The above should work fine if you use the side-by-side layout we recommended earlier.

 

-You should now be able to build any of the test executables in the portaudio\test directory.

-We suggest that you start with patest_saw.c because it's one of the simplest test files.

+Some source code in the ASIO SDK is not compatible with the Win32 API UNICODE mode (The ASIO SDK expects the non-Unicode Win32 API). Therefore you need to make sure your project is set to not use Unicode. You do this by setting the project Character Set to "Use Multi-Byte Character Set" (NOT "Use Unicode Character Set"). In VS2010 the Character Set option can be found at Configuration Properties > General > Character Set. (An alternative to setting the project to non-Unicode is to patch asiolist.cpp to work when UNICODE is defined: put #undef UNICODE at the top of the file before windows.h is included.)

+

+You should now be able to build any of the test executables in the portaudio\\examples directory.

+We suggest that you start with paex_saw.c because it's one of the simplest example files.

 

 --- Chris Share, Tom McCandless, Ross Bencina

 

-[wiki:UsingThePortAudioSvnRepository  SVN instructions]

 Back to the Tutorial: \ref tutorial_start

 

 */
\ No newline at end of file