media/webrtc/signaling/src/sipcc/include/ccapi_line_info.h

Thu, 22 Jan 2015 13:21:57 +0100

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Thu, 22 Jan 2015 13:21:57 +0100
branch
TOR_BUG_9701
changeset 15
b8a032363ba2
permissions
-rw-r--r--

Incorporate requested changes from Mozilla in review:
https://bugzilla.mozilla.org/show_bug.cgi?id=1123480#c6

michael@0 1 /* This Source Code Form is subject to the terms of the Mozilla Public
michael@0 2 * License, v. 2.0. If a copy of the MPL was not distributed with this
michael@0 3 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
michael@0 4
michael@0 5 #ifndef _CCAPI_LINE_INFO_H_
michael@0 6 #define _CCAPI_LINE_INFO_H_
michael@0 7
michael@0 8 #include "ccapi_types.h"
michael@0 9
michael@0 10 /**
michael@0 11 * Get the line ID
michael@0 12 * @param [in] line - line reference handle
michael@0 13 * @return cc_call_handle_t - handle of the call created
michael@0 14 */
michael@0 15 cc_uint32_t CCAPI_lineInfo_getID(cc_lineinfo_ref_t line);
michael@0 16
michael@0 17 /**
michael@0 18 * Get the line Name
michael@0 19 * @param [in] line - line reference handle
michael@0 20 * @return cc_string_t - line Name
michael@0 21 * NOTE: The memory for return string doesn't need to be freed it will be freed when the info reference is freed
michael@0 22 */
michael@0 23 cc_string_t CCAPI_lineInfo_getName(cc_lineinfo_ref_t line);
michael@0 24
michael@0 25 /**
michael@0 26 * Get the line Label
michael@0 27 * @param [in] line - line reference handle
michael@0 28 * @return cc_string_t - line Label
michael@0 29 * NOTE: The memory for return string doesn't need to be freed it will be freed when the info reference is freed
michael@0 30 */
michael@0 31 cc_string_t CCAPI_lineInfo_getLabel(cc_lineinfo_ref_t line);
michael@0 32
michael@0 33 /**
michael@0 34 * Get the line DN Number
michael@0 35 * @param [in] line - line reference handle
michael@0 36 * @return cc_string_t - line DN
michael@0 37 * NOTE: The memory for return string doesn't need to be freed it will be freed when the info reference is freed
michael@0 38 */
michael@0 39 cc_string_t CCAPI_lineInfo_getNumber(cc_lineinfo_ref_t line);
michael@0 40
michael@0 41 /**
michael@0 42 * Get the line External Number
michael@0 43 * @param [in] line - line reference handle
michael@0 44 * @return cc_string_t - line DN
michael@0 45 * NOTE: The memory for return string doesn't need to be freed it will be freedwhen the info reference is freed
michael@0 46 */
michael@0 47 cc_string_t CCAPI_lineInfo_getExternalNumber(cc_lineinfo_ref_t line);
michael@0 48
michael@0 49 /**
michael@0 50 * Get the physical button number on which this line is configured
michael@0 51 * @param [in] line - line reference handle
michael@0 52 * @return cc_uint32_t - button number
michael@0 53 * NOTE: This API is deprecated please don't use this. the CCAPI_lineInfo_getID() returns the button number
michael@0 54 * as we use the button as line id
michael@0 55 */
michael@0 56 cc_uint32_t CCAPI_lineInfo_getButton(cc_lineinfo_ref_t line);
michael@0 57
michael@0 58 /**
michael@0 59 * Get the Line Type
michael@0 60 * @param [in] line - line reference handle
michael@0 61 * @return cc_uint32_t - line featureID ( Line )
michael@0 62 */
michael@0 63 cc_line_feature_t CCAPI_lineInfo_getLineType(cc_lineinfo_ref_t line);
michael@0 64
michael@0 65 /**
michael@0 66 * Get the physical button number on which this line is configured
michael@0 67 * @param [in] line - line reference handle
michael@0 68 * @return cc_uint32_t - button number
michael@0 69 */
michael@0 70 cc_boolean CCAPI_lineInfo_getRegState(cc_lineinfo_ref_t line);
michael@0 71
michael@0 72 /**
michael@0 73 * Get the CFWDAll status for the line
michael@0 74 * @param [in] line - line reference handle
michael@0 75 * @return cc_boolean - isForwarded
michael@0 76 */
michael@0 77 cc_boolean CCAPI_lineInfo_isCFWDActive(cc_lineinfo_ref_t line);
michael@0 78
michael@0 79 /**
michael@0 80 * Get the CFWDAll destination
michael@0 81 * @param [in] line - line reference handle
michael@0 82 * @return cc_string_t - cfwd target
michael@0 83 * NOTE: The memory for return string doesn't need to be freed it will be freed when the info reference is freed
michael@0 84 */
michael@0 85 cc_string_t CCAPI_lineInfo_getCFWDName(cc_lineinfo_ref_t line);
michael@0 86
michael@0 87 /**
michael@0 88 * Get calls on line
michael@0 89 * @param [in] line - lineID
michael@0 90 * @param [in, out] handles[] - Array of callinfo references
michael@0 91 * @param [in,out] count - count of call references populated
michael@0 92 * @return void
michael@0 93 */
michael@0 94 void CCAPI_LineInfo_getCalls(cc_lineid_t line, cc_call_handle_t handles[], int *count);
michael@0 95
michael@0 96 /**
michael@0 97 * Get calls on line by state
michael@0 98 * @param [in] line - lineID
michael@0 99 * @param [in] state - state
michael@0 100 * @param [in, out] handles[] - Array of callinfo references
michael@0 101 * @param [in,out] count - count of call references populated
michael@0 102 * @return void
michael@0 103 */
michael@0 104 void CCAPI_LineInfo_getCallsByState(cc_lineid_t line, cc_call_state_t state,
michael@0 105 cc_call_handle_t handles[], int *count);
michael@0 106
michael@0 107 /**
michael@0 108 * Get the MWI Status
michael@0 109 * @param line - line reference handle
michael@0 110 * @return cc_uint32_t - MWI status (boolean 0 => no MWI)
michael@0 111 */
michael@0 112 cc_uint32_t CCAPI_lineInfo_getMWIStatus(cc_lineinfo_ref_t line);
michael@0 113
michael@0 114 /**
michael@0 115 * Get the MWI Type
michael@0 116 * @param line - line reference handle
michael@0 117 * @return cc_uint32_t - MWI Type
michael@0 118 */
michael@0 119 cc_uint32_t CCAPI_lineInfo_getMWIType(cc_lineinfo_ref_t line);
michael@0 120
michael@0 121 /**
michael@0 122 * Get the MWI new msg count
michael@0 123 * @param line - line reference handle
michael@0 124 * @return cc_uint32_t - MWI new msg count
michael@0 125 */
michael@0 126 cc_uint32_t CCAPI_lineInfo_getMWINewMsgCount(cc_lineinfo_ref_t line);
michael@0 127
michael@0 128 /**
michael@0 129 * Get the MWI old msg count
michael@0 130 * @param line - line reference handle
michael@0 131 * @return cc_uint32_t - MWI old msg count
michael@0 132 */
michael@0 133 cc_uint32_t CCAPI_lineInfo_getMWIOldMsgCount(cc_lineinfo_ref_t line);
michael@0 134
michael@0 135 /**
michael@0 136 * Get the MWI high priority new msg count
michael@0 137 * @param line - line reference handle
michael@0 138 * @return cc_uint32_t - MWI new msg count
michael@0 139 */
michael@0 140 cc_uint32_t CCAPI_lineInfo_getMWIPrioNewMsgCount(cc_lineinfo_ref_t line);
michael@0 141
michael@0 142 /**
michael@0 143 * Get the MWI high priority old msg count
michael@0 144 * @param line - line reference handle
michael@0 145 * @return cc_uint32_t - MWI old msg count
michael@0 146 */
michael@0 147 cc_uint32_t CCAPI_lineInfo_getMWIPrioOldMsgCount(cc_lineinfo_ref_t line);
michael@0 148
michael@0 149 /**
michael@0 150 * has capability - is the feature allowed
michael@0 151 * @param [in] handle - call info handle
michael@0 152 * @param [in] feat_id - feature id
michael@0 153 * @return boolean - is Allowed
michael@0 154 */
michael@0 155 cc_boolean CCAPI_LineInfo_hasCapability(cc_lineinfo_ref_t line, cc_int32_t feat_id);
michael@0 156
michael@0 157 /**
michael@0 158 * get Allowed Feature set
michael@0 159 * @param [in] handle - call info handle
michael@0 160 * @param [in,out] feat_set - array of len CC_CALL_CAP_MAX
michael@0 161 * @return cc_return_t - CC_SUCCESS or CC_FAILURE
michael@0 162 */
michael@0 163 cc_return_t CCAPI_LineInfo_getCapabilitySet(cc_lineinfo_ref_t line, cc_int32_t feat_set[]);
michael@0 164
michael@0 165 #endif /* _CCAPIAPI_LINE_INFO_H_ */

mercurial