DOCUMENT:Q182983  11-JAN-2001  [vbwin]
TITLE   :SAMPLE: PLAYWAVE.EXE Demonstrates How To Play a Sound File
PRODUCT :Microsoft Visual Basic for Windows
PROD/VER:WINDOWS:5.0,6.0
OPER/SYS:
KEYWORDS:kbfile kbsample kbsound kbVBp kbVBp500 kbVBp600 kbWaveAudio kbGrpDSVB kbDSupport

======================================================================
-------------------------------------------------------------------------------
The information in this article applies to:

 - Microsoft Visual Basic Learning Edition for Windows, versions 5.0, 6.0 
 - Microsoft Visual Basic Professional Edition for Windows, versions 5.0, 6.0 
 - Microsoft Visual Basic Enterprise Edition for Windows, versions 5.0, 6.0 
-------------------------------------------------------------------------------

SUMMARY
=======

PLAYWAVE.EXE is a self-extracting compressed file that demonstrates how to play
uncompressed sound files in your Visual Basic program. The sample also displays
the wave data graphically. The project also demonstrates how to use some of the
multimedia API functions.

MORE INFORMATION
================

The following files are available for download from the Microsoft Download
Center:

   Playwave.exe
   (http://download.microsoft.com/download/vb60pro/sample5/1/WIN98/EN-US/Playwave.exe)

For additional information about how to download Microsoft Support files, click
the article number below to view the article in the Microsoft Knowledge Base:

   Q119591 How to Obtain Microsoft Support Files from Online Services

Microsoft used the most current virus detection software available on the date of
posting to scan this file for viruses. Once posted, the file is housed on secure
servers that prevent any unauthorized changes to the file.

When you run the self-extracting executable file, the following files are
expanded into the Wave Audio Sample directory:

 - Form1.frm (5Kb)

 - Form2.frm (4Kb)

 - Module1.bas (9Kb)

 - PlayWave.vbp (1Kb)

 - PlayWave.vbw (1Kb)

 - Readme.txt - Contains some of the same information as this article.

To Run the Sample Project
-------------------------

1. Open the project in Visual Basic.

2. On the Run menu, click Start or press the F5 key to start the program.

3. From the Main Form, click File to open a common dialog control. Select an
   uncompressed sound file. The sound file data appears in the WaveForm Picture
   Form.

4. To play the file, click Play on the Main form. To play the file from a
   different starting or ending point, use the scroll bars to set the start or
   end points and then click play.

   NOTE: The sound file is loaded into memory rather than being read from disk.
   Large sound files can use a significant amount of memory.

REFERENCES
==========

For more information about using the multimedia API functions, please see the
following topics in the Platform SDK documentation:

 - Multimedia Reference

 - WaveForm Audio

 - WaveForm Functions

The following functions are used in this sample project. For specific information
about these functions, see the Platform SDK documentation:

 - Memory Management Functions

   GlobalAlloc
   GlobalLock
   GlobalFree Lib

 - Multimedia Functions

   mmioAscend
   mmioClose
   mmioDescend
   mmioDescendParent
   mmioOpen
   mmioRead
   mmioReadFormat
   mmioStringToFOURCC

   waveOutAddBuffer
   waveOutClose
   waveOutGetDevCaps
   waveOutGetNumDevs
   waveOutOpen
   waveOutPrepareHeader
   waveOutReset
   waveOutStart
   waveOutStop
   waveOutUnprepareHeader
   waveOutWrite

Additional query words: Playwave

======================================================================
Keywords          : kbfile kbsample kbsound kbVBp kbVBp500 kbVBp600 kbWaveAudio kbGrpDSVB kbDSupport 
Technology        : kbVBSearch kbAudDeveloper kbZNotKeyword6 kbZNotKeyword2 kbVB500Search kbVB600Search kbVBA500 kbVBA600 kbVB500 kbVB600
Version           : WINDOWS:5.0,6.0
Issue type        : kbhowto

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  MICROSOFT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 2001.