Home | History | Annotate | Download | only in src 
      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