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(7) for descriptions of the following attributes:


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

SEE ALSO

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

October 12, 2007
SDP_FIND_MEDIA_RTPMAP(3COMMPUTIL)