#include "legato.h"
#include "userInclude.h"

Functions
void	le_mcc_call_StartClient (const char *serviceInstanceName)

void	le_mcc_call_StopClient (void)

void	le_mcc_call_Delete (le_mcc_call_ObjRef_t callRef)

le_result_t	le_mcc_call_Start (le_mcc_call_ObjRef_t callRef)

bool	le_mcc_call_IsConnected (le_mcc_call_ObjRef_t callRef)

le_result_t	le_mcc_call_GetRemoteTel (le_mcc_call_ObjRef_t callRef, char *telPtr, size_t telPtrNumElements)

le_mcc_call_TerminationReason_t	le_mcc_call_GetTerminationReason (le_mcc_call_ObjRef_t callRef)

le_audio_StreamRef_t	le_mcc_call_GetTxAudioStream (le_mcc_call_ObjRef_t callRef)

le_audio_StreamRef_t	le_mcc_call_GetRxAudioStream (le_mcc_call_ObjRef_t callRef)

le_result_t	le_mcc_call_Answer (le_mcc_call_ObjRef_t callRef)

le_result_t	le_mcc_call_HangUp (le_mcc_call_ObjRef_t callRef)

Detailed Description

Legato Modem Call Control include file.

Copyright (C) Sierra Wireless, Inc. 2014. Use of this work is subject to license.

Function Documentation

le_result_t le_mcc_call_Answer ( le_mcc_call_ObjRef_t callRef )

Answers incoming call.

Returns: LE_TIMEOUT No response was received from the Modem.; LE_OK The function succeeded.

Note: If the caller is passing a bad pointer into this function, it is a fatal error, the function will not return.

Parameters

[in] callRef The call reference.

void le_mcc_call_Delete ( le_mcc_call_ObjRef_t callRef )

Call to free up a call reference.

Note: This frees up the reference, but remains active if other holders reference it.; If the caller is passing a bad pointer into this function, it is a fatal error, the function will not return.

Parameters

[in] callRef The call object to free.

le_result_t le_mcc_call_GetRemoteTel	(	le_mcc_call_ObjRef_t	callRef,
		char *	telPtr,
		size_t	telPtrNumElements
	)

Display the remote party telephone number associated with the call.

Output parameter is updated with the telephone number. If the Telephone number string length exceeds the value of 'len' parameter, the LE_OVERFLOW error code is returned and 'telPtr' is used until 'len-1' characters and a null-character is implicitly appended at the end of 'telPtr'. Note the 'len' parameter sould be at least equal to LE_TEL_NMBR_MAX_LEN, otherwise LE_OVERFLOW error code will be common.

Returns: LE_OVERFLOW The Telephone number length exceed the maximum length.; LE_OK The function succeeded.

Note: If the caller is passing a bad pointer into this function, it is a fatal error, the function will not return.

Parameters

[in]	callRef	The call reference to read from.
[out]	telPtr	The telephone number string.
[in]	telPtrNumElements

le_audio_StreamRef_t le_mcc_call_GetRxAudioStream ( le_mcc_call_ObjRef_t callRef )

Called to get the received audio stream. All audio received from the other end of the call is received on this stream.

Returns: Received audio stream reference.

Note: If the caller is passing a bad pointer into this function, it is a fatal error, the function will not return.

Parameters

[in] callRef The call reference to read from.

le_mcc_call_TerminationReason_t le_mcc_call_GetTerminationReason ( le_mcc_call_ObjRef_t callRef )

Called to get the termination reason.

Returns: The termination reason.

Note: If the caller is passing a bad pointer into this function, it is a fatal error, the function will not return.

Parameters

[in] callRef The call reference to read from.

le_audio_StreamRef_t le_mcc_call_GetTxAudioStream ( le_mcc_call_ObjRef_t callRef )

Called to get the transmitted audio stream. All audio generated on this end of the call is sent on this stream.

Returns: Transmitted audio stream reference.

Note: If the caller is passing a bad pointer into this function, it is a fatal error, the function will not return.

Parameters

[in] callRef The call reference to read from.

le_result_t le_mcc_call_HangUp ( le_mcc_call_ObjRef_t callRef )

Disconnect, or hang up, the specifed call. Any active call handlers will be notified.

Returns: LE_TIMEOUT No response was received from the Modem.; LE_OK Function succeeded.

Note: If the caller is passing a bad pointer into this function, it is a fatal error, the function will not return.

Parameters

[in] callRef The call to end.

bool le_mcc_call_IsConnected ( le_mcc_call_ObjRef_t callRef )

Allow the caller to know if the given call is actually connected or not.

Returns: TRUE if the call is connected, FALSE otherwise.

Note: If the caller is passing a bad pointer into this function, it is a fatal error, the function will not return.

Parameters

[in] callRef The call reference to read.

le_result_t le_mcc_call_Start ( le_mcc_call_ObjRef_t callRef )

Start a call attempt.

Asynchronous due to possible time to connect.

As the call attempt proceeds, the profile's registered call event handler receives events.

Returns: LE_OK Function succeed.

Note
As this is an asynchronous call, a successful only confirms a call has been started. Don't assume a call has been successful yet.

If the caller is passing a bad pointer into this function, it is a fatal error, the function will not return.

Parameters

[in] callRef Reference to the call object.

void le_mcc_call_StartClient ( const char * serviceInstanceName )

Start the service for the client main thread

Parameters

[in] serviceInstanceName

void le_mcc_call_StopClient ( void )

Stop the service for the current client thread

Functions

Detailed Description

Function Documentation