/usr/include/sipxtapi/rtcp/ISDESReport.h is in libsipxtapi-dev 3.3.0~test17-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 | //
// Copyright (C) 2006-2013 SIPez LLC. All rights reserved.
//
// Copyright (C) 2004-2006 SIPfoundry Inc.
// Licensed by SIPfoundry under the LGPL license.
//
// Copyright (C) 2004-2006 Pingtel Corp. All rights reserved.
// Licensed to SIPfoundry under a Contributor Agreement.
//
// $$
///////////////////////////////////////////////////////////////////////////////
// Border Guard
#ifndef _ISDESReport_h
#define _ISDESReport_h
#include "rtcp/RtcpConfig.h"
// Includes
#include "IBaseClass.h"
// Defines
#define SDES_CHANGES -1
// Forward Declarations
interface IGetSrcDescription;
/**
*
* Interface Name: ISDESReport
*
* Inheritance: None
*
*
* Description: The ISDESReport interface allows consumers to format and parse
* SDES reports according to the template defined for the RTCP
* SDES payload format. Report elements supported include Name,
* Email, Phone, Location, Application Name, Notes, and Private
* fields.
*
* Notes:
*
*/
interface ISDESReport : public IBaseClass
{
// Public Methods
public:
/**
*
* Method Name: FormatSDESReport
*
*
* Inputs: boolean bHeader -
* TRUE indicates a header should be included
* long lContentMask - Content Mask
* unsigned long ulBufferSize -
* Optional size defining the length allocated for the buffer
*
* Outputs: unsigned char *puchReportBuffer -
* Buffer used to store the contents of the SDES Report
*
* Returns: unsigned long -
* Returns the number of octets written into the buffer.
*
* Description: Constructs an SDES report using the buffer passed in by the
* caller. The Source Description object shall use the period
* count passed to determine which information should be used to
* populate an SDES report.
*
* Usage Notes: The header of the RTCP Report shall be formatted by delegating
* to the base class.
*
*
*/
virtual unsigned long FormatSDESReport(bool bHeader, long lContentMask,
unsigned char *puchReportBuffer,
unsigned long ulBufferSize)=0;
/**
*
* Method Name: ParseSDESReport
*
*
* Inputs: bool bHeader -
* TRUE indicates an RTCP Header preceeds the report
* unsigned char *puchReportBuffer -
* Buffer containing the contents of the SDES Report
*
* Outputs: None
*
* Returns: unsigned long - Number of octet processed
*
* Description: Extracts the contents of an SDES report using the buffer passed
* in by the caller. The Source Description object shall store
* the content and length of data fields extracted from the SDES
* Report.
*
* Usage Notes: The header of the RTCP Report shall be parsed by delegating to
* the base class.
*
*
*/
virtual unsigned long ParseSDESReport(bool bHeader,
unsigned char *puchReportBuffer) = 0;
/**
*
* Method Name: SetSSRC
*
*
* Inputs: unsigned long ulSSRC - Source ID
*
* Outputs: None
*
* Returns: void
*
* Description: Stores the Source Identifier associated with an RTP connection.
*
* Usage Notes: This is an override of the base class method defined in
* CRTCPHeader.
*
*
*
*/
virtual void SetSSRC(ssrc_t ulSSRC) = 0;
/**
*
* Method Name: GetAccessInterface()
*
*
* Inputs: None
*
* Outputs: None
*
* Returns: IGetSrcDescription * -
* Pointer to the Get Src Description Interface
*
* Description: Returns a pointer to the IGetSrcDescription interface used to
* view the contents of an SDES Report.
*
* Usage Notes:
*
*/
virtual IGetSrcDescription * GetAccessInterface(void) = 0;
};
#endif
|