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