
                  Generic WinOS2 Audio Device Support BETA
                                 Readme file


This readme file contains information which describes the Generic WinOS2
Audio BETA.  Prior to the availability of this feature, a WinOS2 audio
device driver was required to obtain multimedia audio support in a WinOS2
session of OS/2.  This feature provides WinOS2 audio playback support for
WinOS2 sessions, for those environments where a WinOS2 device driver is not
available.

An OS/2 Physical Device Driver for the target hardware is required.  This
feature captures the WinOS2 audio requests and translates these messages
into OS/2 multimedia service requests.  The OS/2 Physical Device Driver is
required to operate the audio hardware.


Limitations
-----------

OS/2 Warp 4.0 and above is required.

Only Wave playback is supported at this time by this feature.  Wave record
is not supported.  Neither MIDI nor Mix functions are supported.


Installation instructions
-------------------------

The Generic WinOS2 Audio package is made up of three modules:  VWINAUD.SYS,
WINAUDD.EXE, and OS2AUDIO.DRV.  VWINAUD.SYS and WINAUDD.EXE should be copied
to the [d:]\mmos2 directory of the target OS/2 machine, and OS2AUDIO.DRV
should be copied to [d:]\os2\mdos\winos2\system directory.  CONFIG.SYS
should be updated with these two statements:

  device=[d:]\mmos2\vwinaud.sys
  run=[d:]\mmos2\winaudd.exe

The [d:]\os2\mdos\winos2\system.ini file must be updated so the [drivers]
section refers to the os2audio.drv driver.  Eg

  [drivers]
  wave=os2audio.drv
  timer=timer.drv       (is there by default)


Known bugs
----------

Intermittent Ring 3 trap when feature is operated concurrently with
other OS/2 applications.  Recoverable by ending the Win application and
restarting.

Quicktime sound does not work.

Intermittent hang when playing files less than 0.5 seconds in length.
Recoverable by ending WinOS2 session and restarting.
