4 #if defined(RTAUDIO_EXPORT)
5 #define RTAUDIOAPI __declspec(dllexport)
7 #define RTAUDIOAPI //__declspec(dllimport)
14 typedef unsigned long rtaudio_format_t;
16 #define RTAUDIO_FORMAT_SINT8 0x01
17 #define RTAUDIO_FORMAT_SINT16 0x02
18 #define RTAUDIO_FORMAT_SINT24 0x04
19 #define RTAUDIO_FORMAT_SINT32 0x08
20 #define RTAUDIO_FORMAT_FLOAT32 0x10
21 #define RTAUDIO_FORMAT_FLOAT64 0x20
23 typedef unsigned int rtaudio_stream_flags_t;
25 #define RTAUDIO_FLAGS_NONINTERLEAVED 0x1
26 #define RTAUDIO_FLAGS_MINIMIZE_LATENCY 0x2
27 #define RTAUDIO_FLAGS_HOG_DEVICE 0x4
28 #define RTAUDIO_FLAGS_SCHEDULE_REALTIME 0x8
29 #define RTAUDIO_FLAGS_ALSA_USE_DEFAULT 0x10
31 typedef unsigned int rtaudio_stream_status_t;
33 #define RTAUDIO_STATUS_INPUT_OVERFLOW 0x1
34 #define RTAUDIO_STATUS_OUTPUT_UNDERFLOW 0x2
36 typedef int (*rtaudio_cb_t)(void *out, void *in, unsigned int nFrames,
37 double stream_time, rtaudio_stream_status_t status,
40 typedef enum rtaudio_error {
41 RTAUDIO_ERROR_WARNING,
42 RTAUDIO_ERROR_DEBUG_WARNING,
43 RTAUDIO_ERROR_UNSPECIFIED,
44 RTAUDIO_ERROR_NO_DEVICES_FOUND,
45 RTAUDIO_ERROR_INVALID_DEVICE,
46 RTAUDIO_ERROR_MEMORY_ERROR,
47 RTAUDIO_ERROR_INVALID_PARAMETER,
48 RTAUDIO_ERROR_INVALID_USE,
49 RTAUDIO_ERROR_DRIVER_ERROR,
50 RTAUDIO_ERROR_SYSTEM_ERROR,
51 RTAUDIO_ERROR_THREAD_ERROR,
54 typedef void (*rtaudio_error_cb_t)(rtaudio_error_t err, const char *msg);
56 typedef enum rtaudio_api {
57 RTAUDIO_API_UNSPECIFIED,
58 RTAUDIO_API_LINUX_ALSA,
59 RTAUDIO_API_LINUX_PULSE,
60 RTAUDIO_API_LINUX_OSS,
61 RTAUDIO_API_UNIX_JACK,
62 RTAUDIO_API_MACOSX_CORE,
63 RTAUDIO_API_WINDOWS_WASAPI,
64 RTAUDIO_API_WINDOWS_ASIO,
65 RTAUDIO_API_WINDOWS_DS,
69 #define NUM_SAMPLE_RATES 16
70 #define MAX_NAME_LENGTH 512
71 typedef struct rtaudio_device_info {
73 unsigned int output_channels;
74 unsigned int input_channels;
75 unsigned int duplex_channels;
77 int is_default_output;
80 rtaudio_format_t native_formats;
82 unsigned int preferred_sample_rate;
83 int sample_rates[NUM_SAMPLE_RATES];
85 char name[MAX_NAME_LENGTH];
86 } rtaudio_device_info_t;
88 typedef struct rtaudio_stream_parameters {
89 unsigned int device_id;
90 unsigned int num_channels;
91 unsigned int first_channel;
92 } rtaudio_stream_parameters_t;
94 typedef struct rtaudio_stream_options {
95 rtaudio_stream_flags_t flags;
96 unsigned int num_buffers;
98 char name[MAX_NAME_LENGTH];
99 } rtaudio_stream_options_t;
101 typedef struct rtaudio *rtaudio_t;
103 RTAUDIOAPI const char *rtaudio_version(void);
104 RTAUDIOAPI const rtaudio_api_t *rtaudio_compiled_api(void);
106 RTAUDIOAPI const char *rtaudio_error(rtaudio_t audio);
108 RTAUDIOAPI rtaudio_t rtaudio_create(rtaudio_api_t api);
109 RTAUDIOAPI void rtaudio_destroy(rtaudio_t audio);
111 RTAUDIOAPI rtaudio_api_t rtaudio_current_api(rtaudio_t audio);
113 RTAUDIOAPI int rtaudio_device_count(rtaudio_t audio);
114 RTAUDIOAPI rtaudio_device_info_t rtaudio_get_device_info(rtaudio_t audio,
116 RTAUDIOAPI unsigned int rtaudio_get_default_output_device(rtaudio_t audio);
117 RTAUDIOAPI unsigned int rtaudio_get_default_input_device(rtaudio_t audio);
120 rtaudio_open_stream(rtaudio_t audio, rtaudio_stream_parameters_t *output_params,
121 rtaudio_stream_parameters_t *input_params,
122 rtaudio_format_t format, unsigned int sample_rate,
123 unsigned int *buffer_frames, rtaudio_cb_t cb,
124 void *userdata, rtaudio_stream_options_t *options,
125 rtaudio_error_cb_t errcb);
126 RTAUDIOAPI void rtaudio_close_stream(rtaudio_t audio);
127 RTAUDIOAPI int rtaudio_start_stream(rtaudio_t audio);
128 RTAUDIOAPI int rtaudio_stop_stream(rtaudio_t audio);
129 RTAUDIOAPI int rtaudio_abort_stream(rtaudio_t audio);
131 RTAUDIOAPI int rtaudio_is_stream_open(rtaudio_t audio);
132 RTAUDIOAPI int rtaudio_is_stream_running(rtaudio_t audio);
134 RTAUDIOAPI double rtaudio_get_stream_time(rtaudio_t audio);
135 RTAUDIOAPI void rtaudio_set_stream_time(rtaudio_t audio, double time);
136 RTAUDIOAPI int rtaudio_get_stream_latency(rtaudio_t audio);
137 RTAUDIOAPI unsigned int rtaudio_get_stream_sample_rate(rtaudio_t audio);
139 RTAUDIOAPI void rtaudio_show_warnings(rtaudio_t audio, int show);
144 #endif /* RTAUDIO_C_H */