home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 5 / ctrom5b.zip / ctrom5b / PROGRAM / DIVERSEN / DOS32V3B / LIB / GUS.TXT < prev    next >
Text File  |  1995-03-09  |  2KB  |  33 lines
  1.                     The GUS library  ( GUS.ASM )
  2.  
  3.                                                          By Adam Seychell
  4.  
  5. The GUS library has only three functions and will take care of all
  6. initalization necassary for programming the Gravis Ultrasound sound card.
  7. For a full description of each function please refer to the source code.
  8.  
  9. How to use.
  10.  
  11.     The function GetUltraConfig will return all the settings of the 
  12. ULTRASND environment string. The function will fail if no string was
  13. found or an ileagal DMA,IRQ or Port address setting. Thus if the 
  14. function is successful the parameters returned may always be
  15. used to reset the Ultrasound.
  16.  
  17.     The Ultrasound_Reset function will do a complete reset of the sound
  18. card. The function expects IRQ (gf1), IRQ (midi), DMA (sample), DMA (play)
  19. and Base Port address. If an ileagal DMA or IRQ number is specified then
  20. the function will fail. The function will also fail if an Ultrasound
  21. was not detected at the specified port address. Usually this
  22. function will only need to be called once by your program.
  23.  
  24.     The Ultrasound_Init function simply resets all 32 voices. This function
  25. only be sucessfully called after the Ultrasound_Reset function has previously
  26. been called and was sucessful.
  27.  
  28.     If you wish not to rely on the ULTRASND environment varible to be
  29. set then you may call the Ultrasound_Reset function for all possible
  30. Port address until the function returns sucessful. However, this
  31. may cause problems on certin hardware in some machines. I found some
  32. network cards tend to suffer mostly.
  33.