aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMax Kellermann <max@duempel.org>2009-02-10 18:51:59 +0100
committerMax Kellermann <max@duempel.org>2009-02-10 18:51:59 +0100
commit86d4cf0dbdec08e2f3e793d0ae761bad8d2e5300 (patch)
treebb96ca10785be34ace0772189e0981706f30efec
parentfacf146cfd557d04edeb7d06ca3230dbe86659a3 (diff)
downloadmpd-86d4cf0dbdec08e2f3e793d0ae761bad8d2e5300.tar.gz
mpd-86d4cf0dbdec08e2f3e793d0ae761bad8d2e5300.tar.xz
mpd-86d4cf0dbdec08e2f3e793d0ae761bad8d2e5300.zip
output_all: added API documentation
-rw-r--r--src/output_all.h33
1 files changed, 33 insertions, 0 deletions
diff --git a/src/output_all.h b/src/output_all.h
index 0b782f11b..6f55809f3 100644
--- a/src/output_all.h
+++ b/src/output_all.h
@@ -31,9 +31,16 @@
struct audio_format;
struct tag;
+/**
+ * Global initialization: load audio outputs from the configuration
+ * file and initialize them.
+ */
void
audio_output_all_init(void);
+/**
+ * Global finalization: free memory occupied by audio outputs. All
+ */
void
audio_output_all_finish(void);
@@ -56,21 +63,47 @@ audio_output_get(unsigned i);
struct audio_output *
audio_output_find(const char *name);
+/**
+ * Opens all audio outputs which are not disabled.
+ *
+ * @param audio_format the preferred audio format, or NULL to reuse
+ * the previous format
+ * @return true on success, false on failure
+ */
bool
audio_output_all_open(const struct audio_format *audio_format);
+/**
+ * Closes all audio outputs.
+ */
void
audio_output_all_close(void);
+/**
+ * Play a chunk of audio data.
+ *
+ * @return true on success, false if no audio output was able to play
+ * (all closed then)
+ */
bool
audio_output_all_play(const char *data, size_t size);
+/**
+ * Send metadata for the next chunk.
+ */
void
audio_output_all_tag(const struct tag *tag);
+/**
+ * Puts all audio outputs into pause mode. Most implementations will
+ * simply close it then.
+ */
void
audio_output_all_pause(void);
+/**
+ * Try to cancel data which may still be in the device's buffers.
+ */
void
audio_output_all_cancel(void);