'\" te .\" Copyright (c) 2007, Sun Microsystems Inc. All Rights Reserved. .TH sdp_find_media_rtpmap 3COMMPUTIL "12 Oct 2007" "SunOS 5.11" "Communication Protocol Parser Utilities Library Functions" .SH NAME sdp_find_media_rtpmap \- find the rtpmap attribute in the specified media .SH SYNOPSIS .LP .nf \fBcc\fR [ \fIflag\fR...] \fIfile\fR... -\fBlcommputil\fR [ \fIlibrary\fR...] #include \fBsdp_attr_t *\fR\fBsdp_find_media_rtpmap\fR(\fBsdp_media_t *\fR\fImedia\fR, \fBconst char *\fR\fIformat\fR); .fi .SH DESCRIPTION .sp .LP The \fBsdp_find_media_rtpmap()\fR function searches the attribute list of the specified media structure, \fImedia\fR, for the specified \fIformat\fR. If the search is successful a pointer to that \fIrtpmap\fR attribute is returned. Otherwise it returns \fINULL\fR. .SH RETURN VALUES .sp .LP The \fBsdp_find_media_rtpmap()\fR function returns the attribute (\fBsdp_attr_t *\fR) on success and \fINULL\fR when the search fails or the mandatory input parameters are \fINULL\fR. .SH EXAMPLES .LP \fBExample 1 \fRAn (incomplete) SDP description that contains two media sections: audio and video. .sp .in +2 .nf 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" */ .fi .in -2 .SH ATTRIBUTES .sp .LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp .sp .TS tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . ATTRIBUTE TYPEATTRIBUTE VALUE _ Interface StabilityCommitted _ MT-LevelSafe .TE .SH SEE ALSO .sp .LP \fBlibcommputil\fR(3LIB), \fBsdp_parse\fR(3COMMPUTIL), \fBattributes\fR(5)