03/09/92

M-ACPA Audio API - Version 2.00

            OS/2 and DOS supported

Installation:

   1. Install the Audio Capture and Playback Adapter.  See the Installation
      and Technical Reference Manual for instructions.

   2. Install the audio device driver.

      In the instructions below there may be multiple choices for which
      device driver to load.  The first choice is the smallest device
      driver required by the AAPI.  The second choice may be needed
      because another application that accesses the M-ACPA and may
      be running concurrently requires additional function.  Using the
      first choice when possible will be the most memory efficient.

      The device driver files mentioned below can be found in the
      ..\AUDIODD directory. See the readme file in that directory
      for additional information.

       OS/2:

         Change your config.sys file to add the audio device:
               DEVICE=\your device path\ACPADD2.SYS 1
               IOPL=YES must also be added

         In OS/2 2.0 ONLY, add the following line:
               DEVICE=\your device path\VAUDIO.SYS

               Also copy the file AUDIODD.MSG (found in the ..\AUDIODD
               directory) to the root directory or to a directory that
               is in the system's DPATH.

         Note: If you have the Audio Visual Connection (AVC) product
               installed (with audio capability) then the AVC device
               driver is no longer needed.  Remove the following statement
               from your config.sys file:
                  DEVICE=\system.!av\AEDD_OS2.SYS
               The M-ACPA device driver (ACPADD2.SYS) is completely
               compatible with the AVC driver and also provides additional
               function for other applications.

       OS/2 1.3 COMPATIBILITY BOX only :

         Change your config.sys file to add the audio device:
               DEVICE=\your device path\MINIDD2.SYS or ACPADD2.SYS 1

       DOS:

         Change your config.sys file to add the audio device:
               DEVICE=\your device path\MINIDD.SYS or ACPAK12.SYS 1 or ACPADD.SYS 1

         Note: Installing a device driver in DOS is recommended to
               serialize access to the M-ACPA card but is not required.

       Reboot your system after making any changes.


   3. Copy the following modules into your working directory:

       2play.exe, and record.exe or your application (DOS)
       2play2, and record2.exe or your application   (OS2)


       The following DSP files can be found in the \AUDIODD directory.

       IBMAUDP.DSP  - DSP code for playing ADPCM (voice, music, stereo music)
       IBMAUDR.DSP  -              recording

       IBMAUDF.DSP  -              playing ADPCM (high quality music)
       IBMAUDG.DSP  -              recording

       IBMAUDS.DSP  -              playing (AVC converted MIDI files)

       IBMPCMP.DSP  -              playing PCM
       IBMPCMR.DSP  -              recording

   4.  In OS/2 copy the file AAPIOS2D.DLL into a directory that is in the
       system's DLL path.

   5. To play the sample programs,  type "2play" or "record" at the command
       line and answer the prompts. Hit any key to stop the program.

Files:

   EAPIDOS.LIB  - AAPI large model static link library for DOS
   AAPIOS2D.DLL - AAPI dynamic link library for OS/2
   AAPIOS2D.LIB - Import library for DLL

   PLAY.C       - Simple program example to demonstrate basic AAPI calls


   2PLAY.EXE    - Two track play sample program for DOS or compatibility box
   2PLAY2.EXE   -                                   OS/2
   2PLAY.C

   RECORD.EXE   - Sample program to record in DOS or compatibility box
   RECORD2.EXE  -                             OS/2
   RECORD.C

   PLAY2.DEF    - Sample program definitions files for OS/2
   2PLAY2.DEF
   RECORD2.DEF

   PLAY.H      -  Sample program messages
   2PLAY.H
   RECORD.H

   EXAMPLES.MAK - Make file to compile and link play and record examples
                   for Microsoft C 6.0 or IBM C 1.1.

   EAPIACB.CNC  - Include file that implements the Audio Control Block (C)
                    defined in the AAPI Functional Description.

   EAPIDBAS.CNC - Include file that implements the data structures (C) needed
                  for audio file functions as defined in the AAPI Functional
                  Description.

   MIDI2AVC.EXE - Program to convert Standard MIDI files to Audio Visual
                    Connection MIDI files. Type MIDI2AVC "MIDI file name"
   MIDIACPA.IBM - Voice file to be used with above conversion program.


KNOWN PROBLEMS/RESTRICTIONS

When playing AVC MIDI files the first two seconds of data may play
faster than normal.

PERFORMANCE

The ability to use all of the audio modes that the AAPI supports will
depend on several factors relating to your host machine and environment.  These
items include host system speed, channel speed, host processor disk
performance(speed and fragmentation) and memory availability.  Performance
problems can be identified by the following behavior:

  RECORD - Stops with "Recording media too slow or fragmented" message


  PLAY   -  Sections of good audio intermixed with silence.


If you are experiencing problems attempt to alleviate the problem using
the following suggestions:

Record

1)  Make sure that verify is off on disk writes.

2)  Free up additional space on the disk.

3)  Defragment the hard disk before recording.

4)  Use a VDISK as the file destination of a recording.

Playback

1)  Move the audio file to a VDISK and play it from that location.

2)  Defragment the hard disk before playing.

If the above suggestions do not solve the problem a higher performance system
will be required to use the faster data rate modes.  In slower performance
systems lower data rate modes must be used for proper operation.


DIFFERENCES BETWEEN AAPI VERSIONS 1.3 AND 2.0

Programs developed with previous versions of the AAPI will work with
this new version but do require a re-compile with the latest include
files.

The static OS/2 library (EAPIOS2.LIB) has been replaced with a dynamic
link library (AAPIOS2D.DLL).  This requires linking with the import library
(AAPIOS2D.LIB) and then placing AAPIOS2D.DLL in the system's DLL path.

Additional functional changes include:

        Pulse Code Modulation (PCM) support

            8 or 16 bit sample size

            8000, 11025, 22050, or 44100 sample rates

            Mono or stereo

            Support of Microsoft RIFF WAVE file format

        Source Mix support

         Allows the mixing of an analog signal from any of the M-ACPA input
         sources with the output of playing a PCM file.

        Save/Restore support

         Allows the caller to save the current state of a play or record opera-
         tion, stop the operation, and then restore the saved state and restart
         the operation.

        Removed support for ADPCM mix function


See AAPIFUNC.TXT, the AAPI Functional Description document
for additional information.
