diff avio.h @ 5903:c520016533ed libavformat

Document url_seek().
author stefano
date Sun, 28 Mar 2010 10:31:22 +0000
parents a9a36b4f83a2
children e0e34711fc2e
line wrap: on
line diff
--- a/avio.h	Sun Mar 28 09:59:58 2010 +0000
+++ b/avio.h	Sun Mar 28 10:31:22 2010 +0000
@@ -113,6 +113,21 @@
  */
 int url_read_complete(URLContext *h, unsigned char *buf, int size);
 int url_write(URLContext *h, unsigned char *buf, int size);
+
+/**
+ * Changes the position that will be used by the next read/write
+ * operation on the resource accessed by h.
+ *
+ * @param pos specifies the new position to set
+ * @param whence specifies how pos should be interpreted, it must be
+ * one of SEEK_SET (seek from the beginning), SEEK_CUR (seek from the
+ * current position), SEEK_END (seek from the end), or AVSEEK_SIZE
+ * (return the filesize of the requested resource, pos is ignored).
+ * @return a negative value corresponding to an AVERROR code in case
+ * of failure, or the resulting file position, measured in bytes from
+ * the beginning of the file. You can use this feature together with
+ * SEEK_CUR to read the current file position.
+ */
 int64_t url_seek(URLContext *h, int64_t pos, int whence);
 
 /**