X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=afh.h;h=6dc5a3fc663659b67f658c9ef9b58883adde6266;hp=16c01be33517ff5af95588ab9816812e97635b21;hb=9498eb1c15c7e92c50675e7a951c0c0ea73cd93d;hpb=234647bb5139513bdf36c1afec46f5c43ba27adc

diff --git a/afh.h b/afh.h
index 16c01be3..6dc5a3fc 100644
--- a/afh.h
+++ b/afh.h
@@ -109,6 +109,26 @@ struct audio_format_handler {
 		struct afh_info *afhi);
 	/** Optional, used for header-rewriting. See \ref afh_get_header(). */
 	void (*get_header)(void *map, size_t mapsize, char **buf, size_t *len);
+	/**
+	 * An audio format handler may signify support for dynamic chunks by
+	 * defining ->get_chunk below. In this case the vss calls ->open() at
+	 * BOS, ->get_chunk() for each chunk while streaming, and ->close() at
+	 * EOS. The chunk table is not accessed at all.
+	 *
+	 * The function may return its (opaque) context through the last
+	 * argument. The returned pointer is passed to subsequent calls to
+	 * ->get_chunk() and ->close().
+	 */
+	int (*open)(const void *map, size_t mapsize, void **afh_context);
+	/**
+	 * Return a reference to one chunk. The returned pointer points to a
+	 * portion of the memory mapped audio file. The caller must not call
+	 * free() on it.
+	 */
+	int (*get_chunk)(long unsigned chunk_num, void *afh_context,
+		const char **buf, size_t *len);
+	/** Deallocate the resources occupied by ->open(). */
+	void (*close)(void *afh_context);
 	/**
 	 * Write audio file with altered tags, optional.
 	 *
@@ -124,10 +144,12 @@ int guess_audio_format(const char *name);
 int compute_afhi(const char *path, char *data, size_t size,
 	int fd, struct afh_info *afhi);
 const char *audio_format_name(int);
-void afh_get_chunk(long unsigned chunk_num, struct afh_info *afhi,
-		void *map, const char **buf, size_t *len);
+__must_check int afh_get_chunk(long unsigned chunk_num, struct afh_info *afhi,
+		uint8_t audio_format_id, const void *map, size_t mapsize,
+		const char **buf, size_t *len, void **afh_context);
+void afh_close(void *afh_context, uint8_t audio_format_id);
 int32_t afh_get_start_chunk(int32_t approx_chunk_num,
-		const struct afh_info *afhi);
+		const struct afh_info *afhi, uint8_t audio_format_id);
 void afh_get_header(struct afh_info *afhi, uint8_t audio_format_id,
 		void *map, size_t mapsize, char **buf, size_t *len);
 void afh_free_header(char *header_buf, uint8_t audio_format_id);
@@ -136,3 +158,4 @@ unsigned afh_get_afhi_txt(int audio_format_num, struct afh_info *afhi, char **re
 int afh_rewrite_tags(int audio_format_id, void *map, size_t mapsize,
 		struct taginfo *tags, int output_fd, const char *filename);
 void set_max_chunk_size(struct afh_info *afhi);
+bool afh_supports_dynamic_chunks(int audio_format_id);