From: Luca Abeni <lucabe72@email.it>
Date: Sat, 28 Feb 2009 17:24:56 +0000 (+0000)
Subject: Document ff_rtp_get_codec_info()
X-Git-Tag: v0.5~74
X-Git-Url: http://git.osdn.net/view?a=commitdiff_plain;h=d3a57949583670dab00713401d469fba013d4c7e;p=coroid%2Flibav_saccubus.git

Document ff_rtp_get_codec_info()

Originally committed as revision 17661 to svn://svn.ffmpeg.org/ffmpeg/trunk
---

diff --git a/libavformat/rtp.h b/libavformat/rtp.h
index f340f413c..dbed54e31 100644
--- a/libavformat/rtp.h
+++ b/libavformat/rtp.h
@@ -33,6 +33,18 @@
  */
 int ff_rtp_get_payload_type(AVCodecContext *codec);
 
+/**
+ * Initialize a codec context based on the payload type.
+ *
+ * Fill the codec_type and codec_id fields of a codec context with
+ * information depending on the payload type; for audio codecs, the
+ * channels and sample_rate fields are also filled.
+ *
+ * @param codec The context of the codec
+ * @param payload_type The the payload type (the 'PT' field in the RTP header)
+ * @return In case of unknown payload type or dynamic payload type, a
+ * negative value is returned; otherwise, 0 is returned
+ */
 int ff_rtp_get_codec_info(AVCodecContext *codec, int payload_type);
 const char *ff_rtp_enc_name(int payload_type);
 enum CodecID ff_rtp_codec_id(const char *buf, enum CodecType codec_type);