Thu, 22 Jan 2015 13:21:57 +0100
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_ */ |