• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /* ------------------------------------------------------------------
2  * Copyright (C) 1998-2009 PacketVideo
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
13  * express or implied.
14  * See the License for the specific language governing permissions
15  * and limitations under the License.
16  * -------------------------------------------------------------------
17  */
18 /*                                                                               */
19 /*********************************************************************************/
20 
21 /*
22 **   File:   rtcp_decoder.h
23 **
24 **   Description:
25 **      This module defines the RTCP class. This class is used to encode and
26 **      decode RTCP packets. Please refer to the RTCP design document for
27 **      details.
28 */
29 
30 #ifndef RTCP_DECODER_H
31 #define RTCP_DECODER_H
32 
33 /*
34 ** Includes
35 */
36 #ifndef OSCL_TYPES_H_INCLUDED
37 #include "oscl_types.h"
38 #endif
39 #ifndef OSCL_BIN_STREAM_H_INCLUDED
40 #include "oscl_bin_stream.h"
41 #endif
42 #ifndef RTCP_H
43 #include "rtcp.h"
44 #endif
45 
46 /*
47 ** Constants
48 */
49 
50 /*
51 ** Classes
52 */
53 
54 
55 /*
56 **      This class is used to encode and
57 **      decode RTCP packets. Please refer to the RTCP design document for
58 **      details.
59 */
60 class RTCP_Decoder : public RTCP_Base
61 {
62     public:
63 
64         typedef enum
65         {
66             RTCP_SUCCESS,
67             FAIL,
68             UNSUPPORTED_RTCP_VERSION,
69             RTCP_PACKET_TYPE_MISMATCH,
70             RTCP_LENGTH_MISMATCH,
71             EOS_ON_READ,
72             UNSUPPORTED_RTCP_PVSS_APP
73         } Error_t;
74 
75         OSCL_IMPORT_REF   RTCP_Decoder(const uint8 version = DEFAULT_RTPRTCP_VERSION);
76         OSCL_IMPORT_REF   ~RTCP_Decoder();
77 
78 
79         /*
80          * The scan_compound_packet routine will process the compound packet
81          * and fill the array of packet types and MemoryFragments (up to
82          * the array_size specified).  The caller provides the space for the
83          * arrays that are filled by this routine.
84          */
85         OSCL_IMPORT_REF    Error_t scan_compound_packet(OsclMemoryFragment& input_packet,
86                 int32 max_array_size, int32& filled_size,
87                 RTCPPacketType *array_of_packet_types,
88                 OsclMemoryFragment *array_of_packets);
89 
90         OSCL_IMPORT_REF  Error_t DecodeRR(OsclMemoryFragment& input_packet,
91                                           RTCP_RR& rr_packet);
92 
93         OSCL_IMPORT_REF    Error_t DecodeSR(const OsclMemoryFragment& input_packet,
94                                             RTCP_SR& sr_packet);
95 
96         OSCL_IMPORT_REF Error_t DecodeSDES(const OsclMemoryFragment& input_packet,
97                                            RTCP_SDES& sdes_packet);
98 
99 
100         OSCL_IMPORT_REF    Error_t DecodeBYE(const OsclMemoryFragment& input_packet,
101                                              RTCP_BYE& bye_packet);
102 
103         OSCL_IMPORT_REF  Error_t DecodeAPP(const OsclMemoryFragment& input_packet,
104                                            RTCP_APP& bye_packet);
105 
106 
107     private:
108 
109         Error_t DecodeReportBlock(/* Input stream reference */
110             OsclBinIStreamBigEndian & inStream,
111             RTCP_ReportBlock* report
112         );
113 
114         Error_t DecodeSDESChunk(OsclBinIStreamBigEndian & inStream,
115                                 SDES_chunk* sdes_chunk,
116                                 OsclMemoryFragment& chunk_data);
117 
118 
119 
120 };
121 
122 #endif
123