Subversion Repositories Kolibri OS

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
646 serge 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