- * @param flags pointer to an integer containing the packet flags, may be
- updated
- * @param ts pointer to timestamp, may be updated
- * @return >=0 on success (where >0 indicates there are cached samples that
- * can be retrieved with subsequent calls to ff_rm_retrieve_cache()),
- * errno codes on error
+ * @param flags the packet flags
+ * @param ts timestamp of the current packet
+ * @return <0 on error, 0 if a packet was placed in the pkt pointer. A
+ * value >0 means that no data was placed in pkt, but that cached
+ * data is available by calling ff_rm_retrieve_cache().