opensolaris man page for sdp_find_media_rtpmap

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)