DOCUMENT:Q182983  26-MAR-1998  [vbwin]
TITLE   :FILE: Playwave.exe Demonstrates How To Play a Sound File
PRODUCT :Microsoft Visual Basic for Windows
PROD/VER:WINDOWS:5.0
OPER/SYS:WINDOWS
KEYWORDS:vb5all vb5howto kbsample

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

 - Microsoft Visual Basic Learning, Professional, and Enterprise Editions
   for Windows, version 5.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 file is available for download from the Microsoft Software
Library:

 ~ Playwave.exe

For more information about downloading files from the Microsoft Software
Library, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q119591
   TITLE     : How to Obtain Microsoft Support Files from Online Services

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
======================================================================
Keywords          : vb5all vb5howto kbsample
Version           : WINDOWS:5.0
Platform          : WINDOWS
Solution Type     : kbfile kbsample

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

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 1998.