Current File : //usr/share/man/man3commputil/sdp_find_media_rtpmap.3commputil

'\" 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 <sdp.h>

\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)