home *** CD-ROM | disk | FTP | other *** search
/ Sound, Music & MIDI Collection 2 / SMMVOL2.bin / MIDI_PAT / MTOOLS.ZIP / PLAYRDEV.EXE / PRC.DOC < prev    next >
Encoding:
Text File  |  1992-11-07  |  2.1 KB  |  53 lines
  1. -----------------------------------------------------------------------------
  2.  
  3.              PRC - Diagnostic program for Play/R and Play/D
  4.  
  5. -----------------------------------------------------------------------------
  6.             Copyright 1992, Kevin Weiner, All rights reserved
  7.  
  8.                Proprietary material - not for distribution
  9. ----------------------------------------------------------------------------- 
  10.  
  11. PRC is intended to exercise various MIDI engine API functions by sending
  12. commands to the TSR from the command line.  It may also be used to
  13. control some useful player functions from languages which do not provide
  14. an interrupt facility, but which do provide a way to execute DOS commands. 
  15.  
  16. Run playd or playr first, then type prc and an API function number. 
  17. Respond to any prompts (for functions 4 and 8, the file name may be
  18. added to the command line).  Where a device number is requested, 1 is a
  19. appropriate response.  To test MIDI output, either load a file with
  20. function 4, or use function 21 to play a single note.  To test input,
  21. send some input from a keyboard or other device and then use function 24
  22. to read it.  To test large dumps, you must have used -Sn on the playd
  23. line to set it's input buffer to nK bytes.  Otherwise, polled input and
  24. a small buffer are used. 
  25.  
  26.  API Function   Use
  27.  
  28.       0         Pause play
  29.       1         Continue play
  30.       2         n/a
  31.       3         Rewind
  32.       4         Load file & start
  33.       5         Get song status
  34.       6         Get file load status
  35.       7         n/a
  36.       8         Load file & pause
  37.       9         Silence playing notes
  38.       10        n/a
  39.       11        Volume adjust
  40.       12        Reset MIDI device
  41.       13        Set timer mode
  42.       14        Get channel map
  43.       15        Set channel map
  44.       16-19     n/a
  45.       20        Get device name
  46.       21        Play a note
  47.       22        n/a
  48.       23        Check for waiting input
  49.       24        Get waiting input
  50.       25        Get millisecond time
  51.       99        Remove Play/D from memory
  52.  
  53.