Add a comment that explains why this header has no multiple inclusion guards.
[mplayer/greg.git] / libao2 / audio_out.h
blob09092642489c25eb5e42f4ad57116c67920aca2f
2 #ifndef AUDIO_OUT_H
3 #define AUDIO_OUT_H
5 typedef struct ao_info_s
7 /* driver name ("Matrox Millennium G200/G400" */
8 const char *name;
9 /* short name (for config strings) ("mga") */
10 const char *short_name;
11 /* author ("Aaron Holtzman <aholtzma@ess.engr.uvic.ca>") */
12 const char *author;
13 /* any additional comments */
14 const char *comment;
15 } ao_info_t;
17 /* interface towards mplayer and */
18 typedef struct ao_functions_s
20 ao_info_t *info;
21 int (*control)(int cmd,void *arg);
22 int (*init)(int rate,int channels,int format,int flags);
23 void (*uninit)(int immed);
24 void (*reset)(void);
25 int (*get_space)(void);
26 int (*play)(void* data,int len,int flags);
27 float (*get_delay)(void);
28 void (*pause)(void);
29 void (*resume)(void);
30 } ao_functions_t;
32 /* global data used by mplayer and plugins */
33 typedef struct ao_data_s
35 int samplerate;
36 int channels;
37 int format;
38 int bps;
39 int outburst;
40 int buffersize;
41 int pts;
42 } ao_data_t;
44 extern char *ao_subdevice;
45 extern ao_data_t ao_data;
47 void list_audio_out(void);
48 ao_functions_t* init_best_audio_out(char** ao_list,int use_plugin,int rate,int channels,int format,int flags);
50 // NULL terminated array of all drivers
51 extern ao_functions_t* audio_out_drivers[];
53 #define CONTROL_OK 1
54 #define CONTROL_TRUE 1
55 #define CONTROL_FALSE 0
56 #define CONTROL_UNKNOWN -1
57 #define CONTROL_ERROR -2
58 #define CONTROL_NA -3
60 #define AOCONTROL_SET_DEVICE 1
61 #define AOCONTROL_GET_DEVICE 2
62 #define AOCONTROL_QUERY_FORMAT 3 /* test for availabilty of a format */
63 #define AOCONTROL_GET_VOLUME 4
64 #define AOCONTROL_SET_VOLUME 5
65 #define AOCONTROL_SET_PLUGIN_DRIVER 6
66 #define AOCONTROL_SET_PLUGIN_LIST 7
68 #define AOPLAY_FINAL_CHUNK 1
70 typedef struct ao_control_vol_s {
71 float left;
72 float right;
73 } ao_control_vol_t;
75 #endif /* AUDIO_OUT_H */