Subversion Repositories Kolibri OS

Rev

Blame | Last modification | View Log | Download | RSS feed

  1. /*
  2.    uFMOD AC97SND codec header file
  3.    Target OS: KolibriOS
  4.    Compiler:  Visual C
  5.  
  6.    NOTE: ufmod.obj should be rebuilt setting UF_MODE=AC97SND
  7.    in order to make it usable in AC97SND player.
  8.  
  9.    The Infinity Sound driver handle should be available as
  10.    a public symbol named hSound. It is so when using Serge's
  11.    sound.lib.
  12. */
  13.  
  14. #ifdef __cplusplus
  15.         extern "C" {
  16. #endif
  17.  
  18. /* HANDLE uFMOD_LoadSong(char *lpXM);
  19.    ---
  20.    Description:
  21.    ---
  22.       Loads the given XM song and starts playing it as soon as you
  23.       call uFMOD_WaveOut for the first time. It will stop any
  24.       currently playing song before loading the new one. Heap should
  25.       be initialized before calling this function!
  26.    ---
  27.    Parameters:
  28.    ---
  29.      lpXM
  30.         Specifies the filename of the song to load.
  31.    ---
  32.    Return Values:
  33.    ---
  34.       On success, returns a non zero value. Returns 0 on failure.
  35. */
  36. int __cdecl uFMOD_LoadSong(char*);
  37.  
  38. /* int uFMOD_WaveOut(SNDBUF hBuff)
  39.    ---
  40.    Description:
  41.    ---
  42.       Updates the internal playback buffer.
  43.    ---
  44.    Parameters:
  45.    ---
  46.      hBuff
  47.         The Infinity Sound buffer to update.
  48.    ---
  49.    Remarks:
  50.    ---
  51.       Playback doesn't actually begin when calling uFMOD_LoadSong,
  52.       but when calling uFMOD_WaveOut after a successful uFMOD_LoadSong
  53.       call. Afterwards, you should call uFMOD_WaveOut repeatedly at
  54.       least once every 250 ms to prevent "buffer underruns".
  55.       uFMOD_WaveOut is a non-blocking function.
  56.    ---
  57.    Return Values:
  58.    ---
  59.       Returns non zero on error.
  60. */
  61. int __cdecl uFMOD_WaveOut(unsigned int);
  62.  
  63. /* void uFMOD_StopSong(void)
  64.    ---
  65.    Description:
  66.    ---
  67.       Stops the currently playing song, freeing the associated
  68.       resources.
  69.    ---
  70.    Remarks:
  71.    ---
  72.       Does nothing if no song is playing at the time the call is made.
  73. */
  74. void __cdecl uFMOD_StopSong();
  75.  
  76. /* unsigned char* _uFMOD_GetTitle(void)
  77.    ---
  78.    Description:
  79.    ---
  80.       Returns the current song's title.
  81.    ---
  82.    Remarks:
  83.    ---
  84.       Not every song has a title, so be prepared to get an empty string.
  85. */
  86. unsigned char* __cdecl uFMOD_GetTitle();
  87.  
  88. #ifdef __cplusplus
  89.         }
  90. #endif
  91.