michael@0: /* This Source Code Form is subject to the terms of the Mozilla Public
michael@0:  * License, v. 2.0. If a copy of the MPL was not distributed with this
michael@0:  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
michael@0: 
michael@0: #ifndef _CCAPI_LINE_H_
michael@0: #define _CCAPI_LINE_H_
michael@0: 
michael@0: #include "ccapi_types.h"
michael@0: 
michael@0: /**
michael@0:  * Get reference handle for the line
michael@0:  * @param [in] line - lineID on which to create call
michael@0:  * @return cc_call_handle_t - handle of the call created
michael@0:  * NOTE: The info returned by this method must be released using CCAPI_Line_releaseLineInfo()
michael@0:  */
michael@0: cc_lineinfo_ref_t CCAPI_Line_getLineInfo(cc_uint32_t line);
michael@0: 
michael@0: /**
michael@0:  * Create a call on the line
michael@0:  * @param [in] line - lineID on which to create call
michael@0:  * @return cc_call_handle_t - handle of the call created
michael@0:  */
michael@0: cc_call_handle_t CCAPI_Line_CreateCall(cc_lineid_t line);
michael@0: 
michael@0: /**
michael@0:  * Retain the lineInfo snapshot - this info shall not be freed until a
michael@0:  * CCAPI_Line_releaseLineInfo() API releases this resource.
michael@0:  * @param [in] ref - reference to the block to be retained
michael@0:  * @return void
michael@0:  * NOTE: Application may use this API to retain the device info using this API inside
michael@0:  * CCAPI_LineListener_onLineEvent() App must release the Info using
michael@0:  * CCAPI_Line_releaseLineInfo() once it is done with it.
michael@0:  */
michael@0: void CCAPI_Line_retainLineInfo(cc_lineinfo_ref_t ref);
michael@0: 
michael@0: /**
michael@0:  * Release the lineInfo snapshot that was retained using the CCAPI_Line_retainLineInfo API
michael@0:  * @param [in] ref - line info reference to be freed
michael@0:  * @return void
michael@0:  */
michael@0: void CCAPI_Line_releaseLineInfo(cc_lineinfo_ref_t ref);
michael@0: 
michael@0: #endif /* _CCAPIAPI_LINE_H_ */