sdp_find_media_rtpmap(3COMMPUTIL)

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)