sdp_find_media_rtpmap(3COMMPUTIL) Communication Protocol Parser Utilities Library Functions 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)
SunOS 5.11 12 Oct 2007 sdp_find_media_rtpmap(3COMMPUTIL)