SDP_FIND_MEDIA_RTPMAP(3COMMPUTIL)
Communication Protocol Parser Utilities Library Functions


NAME


sdp_find_media_rtpmap - find the rtpmap attribute in the specified media

SYNOPSIS


cc [ flag...] file... -lcommputil [ library...]
#include <sdp.h>

sdp_attr_t *sdp_find_media_rtpmap(sdp_media_t *media,
const char *format);


DESCRIPTION


The sdp_find_media_rtpmap() function searches the attribute list of the
specified media structure, media, for the specified format. If the search
is successful a pointer to that rtpmap attribute is returned. Otherwise
it returns NULL.

RETURN VALUES


The sdp_find_media_rtpmap() function returns the attribute (sdp_attr_t *)
on success and NULL when the search fails or the mandatory input
parameters are NULL.

EXAMPLES


Example 1: An (incomplete) SDP description that contains two media


sections: audio and video.

m=audio 49170 RTP/AVP 0 8
a=rtpmap:0 PCMU/8000
a=rtpmap:8 PCMA/8000
m=video 51372 RTP/AVP 31 32
a=rtpmap:31 H261/90000
a=rtpmap:32 MPV/90000

/*
* Assuming that above description is parsed using sdp_parse() and that
* the parsed structure is in "session" sdp_session_t structure.
*/

sdp_media_t *video;
sdp_attr_t *mpv;

video = sdp_find_media(session->s_media, "video);
mpv = sdp_find_media_rtpmap(video, "32");

/*
* Now the attribute structure sdp_attr_t, mpv will be having
* values from the attribute field "a=rtpmap:32 MPV/90000"
*/


ATTRIBUTES


See attributes(5) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Committed |
+--------------------+-----------------+
|MT-Level | Safe |
+--------------------+-----------------+

SEE ALSO


libcommputil(3LIB), sdp_parse(3COMMPUTIL), attributes(5)


October 12, 2007
SDP_FIND_MEDIA_RTPMAP(3COMMPUTIL)