Speech Calls Service
[Telephony Mgr]


Detailed Description

This service groups the Telephony speech calls functions.


Data Structures

struct  _AlpTelSpcAlsLineIdRangeType
struct  _AlpTelSpcCall
struct  _AlpTelSpcCalls
struct  _AlpTelSpcToneDurationRange

Defines

#define ALP_TEL_IS_SPC_ACCEPT_CALL_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_ACCEPT_CALL_MESSAGE)
#define ALP_TEL_IS_SPC_ADD_HELD_CALL_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_ADD_HELD_CALL_MESSAGE)
#define ALP_TEL_IS_SPC_ALS_GET_LINE_ID_RANGE_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_ALS_GET_LINEID_RANGE_MESSAGE)
#define ALP_TEL_IS_SPC_ALS_GET_LINE_ID_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_ALS_GET_LINEID_MESSAGE)
#define ALP_TEL_IS_SPC_ALS_SET_LINE_ID_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_ALS_SET_LINEID_MESSAGE)
#define ALP_TEL_IS_SPC_CALL_COMPLETION_TO_BUSY_SUBSCRIBER_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_CALL_COMPLETION_TO_BUSY_SUBSCRIBER_MESSAGE)
#define ALP_TEL_IS_SPC_CALL_DEFLECTION_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_CALL_DEFLECTION_MESSAGE)
#define ALP_TEL_IS_SPC_EXPLICIT_CALL_TRANSFERT_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_EXPLICIT_CALL_TRANSFERT_MESSAGE)
#define ALP_TEL_IS_SPC_GET_CALL_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_GET_CALL_MESSAGE)
#define ALP_TEL_IS_SPC_GET_CALLS_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_GET_CALLS_MESSAGE)
#define ALP_TEL_IS_SPC_GET_TONE_DURATION_RANGE_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_GET_TONE_DURATION_RANGE_MESSAGE)
#define ALP_TEL_IS_SPC_GET_TONE_DURATION_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_GET_TONE_DURATION_MESSAGE)
#define ALP_TEL_IS_SPC_HOLD_ACTIVE_CALLS_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_HOLD_ACTIVE_CALLS_MESSAGE)
#define ALP_TEL_IS_SPC_INITIATE_CALL_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_INITIATE_CALL_MESSAGE)
#define ALP_TEL_IS_SPC_PLAY_TONE_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_PLAY_TONE_MESSAGE)
#define ALP_TEL_IS_SPC_PRIVATE_CALL_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_PRIVATE_CALL_MESSAGE)
#define ALP_TEL_IS_SPC_RELEASE_CALL_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_RELEASE_CALL_MESSAGE)
#define ALP_TEL_IS_SPC_SEND_DTMF_STRING_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_SEND_DTMF_STRING_MESSAGE)
#define ALP_TEL_IS_SPC_SET_TONE_DURATION_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_SET_TONE_DURATION_MESSAGE)
#define ALP_TEL_SPC_ACCEPT_CALL_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0003)
#define ALP_TEL_SPC_ADD_HELD_CALL_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0006)
#define ALP_TEL_SPC_ALL_ACTIVE_CALLS   0xF1
#define ALP_TEL_SPC_ALL_CALLS   0xF0
#define ALP_TEL_SPC_ALL_HELD_CALLS   0xF2
#define ALP_TEL_SPC_ALS_GET_LINEID_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x000D)
#define ALP_TEL_SPC_ALS_GET_LINEID_RANGE_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x000C)
#define ALP_TEL_SPC_ALS_SET_LINEID_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x000E)
#define ALP_TEL_SPC_CALL_COMPLETION_TO_BUSY_SUBSCRIBER_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0011)
#define ALP_TEL_SPC_CALL_DEFLECTION_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x000F)
#define ALP_TEL_SPC_CALLER_ID_NOT_AVAILABLE   2
#define ALP_TEL_SPC_CALLER_ID_VALID   0
#define ALP_TEL_SPC_CALLER_ID_WITHHELD   1
#define ALP_TEL_SPC_CALLING_LINE_ID   0xFF
 ID of a calling line. We can't provide a real ID knowing that an error might occur after TelSpcCallNumber return... So use this one to 'close' the line.
#define ALP_TEL_SPC_DIALING_CALL   0
#define ALP_TEL_SPC_DIRECTION_MOBILE_ORIGINATED   0
 Mobile originated call.
#define ALP_TEL_SPC_DIRECTION_MOBILE_TERMINATED   1
 Mobile terminated call.
#define ALP_TEL_SPC_DTMF_STRING_MAX_LENGTH   29
 Max length of the DTMF string.
#define ALP_TEL_SPC_ERROR_CALL_BARRED   2
 The call has been barred by the network.
#define ALP_TEL_SPC_ERROR_COST_LIMIT   1
 The call has failed due to cost limit reached.
#define ALP_TEL_SPC_EXPLICIT_CALL_TRANSFERT_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0010)
#define ALP_TEL_SPC_GET_CALL_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0001)
#define ALP_TEL_SPC_GET_CALLS_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0000)
#define ALP_TEL_SPC_GET_TONE_DURATION_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x000A)
#define ALP_TEL_SPC_GET_TONE_DURATION_RANGE_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0009)
#define ALP_TEL_SPC_GPRS_LINE_ID   0xFE
 ID of a GPRS line.
#define ALP_TEL_SPC_HOLD_ACTIVE_CALLS_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0005)
#define ALP_TEL_SPC_INCOMING_CALL   0xF3
#define ALP_TEL_SPC_INITIATE_CALL_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0002)
#define ALP_TEL_SPC_MAX_CALL_COUNT   6
 Max number of calls at the same time.
#define ALP_TEL_SPC_MESSAGES_COUNT   ((ALP_TEL_SPC_SEND_DTMF_STRING_MESSAGE & ALP_TEL_MESSAGE_MASK) + 1)
 Total count of speech call service messages.
#define ALP_TEL_SPC_MODE_DATA   1
 Data call.
#define ALP_TEL_SPC_MODE_FAX   2
 Fax call.
#define ALP_TEL_SPC_MODE_VIDEO   3
 Video telephony call.
#define ALP_TEL_SPC_MODE_VOICE   0
 Voice call.
#define ALP_TEL_SPC_PLAY_TONE_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0008)
#define ALP_TEL_SPC_PRIVATE_CALL_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0007)
#define ALP_TEL_SPC_RELEASE_CALL_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0004)
#define ALP_TEL_SPC_SEND_DTMF_STRING_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0012)
#define ALP_TEL_SPC_SET_TONE_DURATION_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x000B)
#define ALP_TEL_SPC_SS_INFO_CALL_HELD   0x61
 During a call: Call has been put on hold.
#define ALP_TEL_SPC_SS_INFO_CALL_JOINED   0x63
 During a call: Multiparty call entered.
#define ALP_TEL_SPC_SS_INFO_CALL_ON_HOLD_RELEASED   0x64
 During a call: Call on hold has been released.
#define ALP_TEL_SPC_SS_INFO_CALL_RETRIEVED   0x62
 During a call: Call has been retrieved.
#define ALP_TEL_SPC_SS_INFO_CALL_TRANSFERED   0x36
 During a mobile terminated call setup or during a call: Call has been connected with the other remote party in explicit call transfer operation.
#define ALP_TEL_SPC_SS_INFO_CALL_TRANSFERED_ACTIVE   0x66
 During a call: Call has been connected with the other remote party in explicit call transfer operation.
#define ALP_TEL_SPC_SS_INFO_CALL_TRANSFERED_ALERTING   0x65
 During a call: Call is being connected (alerting) with the remote party in alerting state in explicit call transfer operation.
#define ALP_TEL_SPC_SS_INFO_FORWARD_RECEIVED   0x67
 During a call: forward check SS message received(can be received whenever).
#define ALP_TEL_SPC_SS_INFO_MO_CALL_DEFLECTED   0x07
 Originated call setup: Call has been deflected.
#define ALP_TEL_SPC_SS_INFO_MO_CALL_FORWARDED   0x04
 Originated call setup: Call has been forwarded.
#define ALP_TEL_SPC_SS_INFO_MO_CALL_IS_WAITING   0x02
 Originated call setup: Call is waiting.
#define ALP_TEL_SPC_SS_INFO_MO_CLIR_SUPPRESSION_REJECTED   0x08
 Originated call setup: CLIR suppression rejected.
#define ALP_TEL_SPC_SS_INFO_MO_CONDITIONAL_CALL_FORWARD   0x0A
 Originated call setup: some of the conditional call forwardings are active.
#define ALP_TEL_SPC_SS_INFO_MO_CONNECTED_PARTY_NUMBER   0x01
 Originated call setup: Connected party number.
#define ALP_TEL_SPC_SS_INFO_MO_CUG_CALL   0x03
 Originated call setup: This is a CUG call.
#define ALP_TEL_SPC_SS_INFO_MO_INCOMING_CALL_BARRED   0x05
 Originated call setup: Incoming call is barred(MO).
#define ALP_TEL_SPC_SS_INFO_MO_OUTGOING_CALL_BARRED   0x06
 Originated call setup: Outgoing call is barred(MO).
#define ALP_TEL_SPC_SS_INFO_MO_UNCONDITIONAL_CALL_FORWARD   0x09
 Originated call setup: unconditional call forwarding is active.
#define ALP_TEL_SPC_SS_INFO_MT_CALL_DEFLECTED   0x35
 During a mobile terminated call setup or during a call: This is a deflected call.
#define ALP_TEL_SPC_SS_INFO_MT_CALL_FORWARDED   0x33
 During a mobile terminated call setup or during a call: This is a forwarded call.
#define ALP_TEL_SPC_SS_INFO_MT_CALLING_PARTY_NAME   0x32
 During a mobile terminated call setup or during a call: Calling party name(CNA).
#define ALP_TEL_SPC_SS_INFO_MT_CALLING_PARTY_NUMBER   0x31
 During a mobile terminated call setup or during a call: Calling party number(CLI).
#define ALP_TEL_SPC_SS_INFO_MT_CUG_CALL   0x34
 During a mobile terminated call setup or during a call: This is a CUG call.
#define ALP_TEL_SPC_STATUS_ACTIVE   0
#define ALP_TEL_SPC_STATUS_ALERTING   3
 MO call.
#define ALP_TEL_SPC_STATUS_DIALING   2
 MO call.
#define ALP_TEL_SPC_STATUS_HELD   1
#define ALP_TEL_SPC_STATUS_INCOMING   4
 MT call.
#define ALP_TEL_SPC_STATUS_RELEASED   6
#define ALP_TEL_SPC_STATUS_WAITING   5
 MT call.

Typedefs

typedef _AlpTelSpcAlsLineIdRangeType AlpTelSpcAlsLineIdRange
typedef _AlpTelSpcCall AlpTelSpcCall
typedef _AlpTelSpcCalls AlpTelSpcCalls
typedef _AlpTelSpcToneDurationRange AlpTelSpcToneDurationRange

Functions

alp_status_t alp_tel_spc_accept_call (AlpTelApplicationId iAppId, AlpTelSpcCall *oCallP, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_add_held_call (AlpTelApplicationId iAppId, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_als_get_line_id (AlpTelApplicationId iAppId, uint16_t *oLineIdP, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_als_get_line_id_range (AlpTelApplicationId iAppId, AlpTelSpcAlsLineIdRange *oLineIdRangeP, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_als_set_line_id (AlpTelApplicationId iAppId, uint16_t iLineId, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_call_completion_to_busy_subscriber (AlpTelApplicationId iAppId, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_call_deflection (AlpTelApplicationId iAppId, AlpTelNumber *iNumberP, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_explicit_call_transfert (AlpTelApplicationId iAppId, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_get_call (AlpTelApplicationId iAppId, AlpTelSpcCall *ioCallP, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_get_calls (AlpTelApplicationId iAppId, AlpTelSpcCalls *ioCallsP, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_get_tone_duration (AlpTelApplicationId iAppId, uint16_t *ioToneDurationP, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_get_tone_duration_range (AlpTelApplicationId iAppId, AlpTelSpcToneDurationRange *ioToneDurationRangeP, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_hold_active_calls (AlpTelApplicationId iAppId, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_initiate_call (AlpTelApplicationId iAppId, AlpTelSpcCall *ioCallP, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_play_tone (AlpTelApplicationId iAppId, char iTone, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_private_call (AlpTelApplicationId iAppId, uint8_t iCallId, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_release_call (AlpTelApplicationId iAppId, uint8_t iCallId, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_send_dtmf_string (AlpTelApplicationId iAppId, char *iDtmfStringP, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_spc_set_tone_duration (AlpTelApplicationId iAppId, uint16_t iToneDuration, AlpTelTransId *ioTransIdP)


Define Documentation

#define ALP_TEL_IS_SPC_ACCEPT_CALL_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_ACCEPT_CALL_MESSAGE)
 

#define ALP_TEL_IS_SPC_ADD_HELD_CALL_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_ADD_HELD_CALL_MESSAGE)
 

#define ALP_TEL_IS_SPC_ALS_GET_LINE_ID_RANGE_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_ALS_GET_LINEID_RANGE_MESSAGE)
 

#define ALP_TEL_IS_SPC_ALS_GET_LINE_ID_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_ALS_GET_LINEID_MESSAGE)
 

#define ALP_TEL_IS_SPC_ALS_SET_LINE_ID_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_ALS_SET_LINEID_MESSAGE)
 

#define ALP_TEL_IS_SPC_CALL_COMPLETION_TO_BUSY_SUBSCRIBER_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_CALL_COMPLETION_TO_BUSY_SUBSCRIBER_MESSAGE)
 

#define ALP_TEL_IS_SPC_CALL_DEFLECTION_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_CALL_DEFLECTION_MESSAGE)
 

#define ALP_TEL_IS_SPC_EXPLICIT_CALL_TRANSFERT_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_EXPLICIT_CALL_TRANSFERT_MESSAGE)
 

#define ALP_TEL_IS_SPC_GET_CALL_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_GET_CALL_MESSAGE)
 

#define ALP_TEL_IS_SPC_GET_CALLS_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_GET_CALLS_MESSAGE)
 

#define ALP_TEL_IS_SPC_GET_TONE_DURATION_RANGE_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_GET_TONE_DURATION_RANGE_MESSAGE)
 

#define ALP_TEL_IS_SPC_GET_TONE_DURATION_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_GET_TONE_DURATION_MESSAGE)
 

#define ALP_TEL_IS_SPC_HOLD_ACTIVE_CALLS_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_HOLD_ACTIVE_CALLS_MESSAGE)
 

#define ALP_TEL_IS_SPC_INITIATE_CALL_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_INITIATE_CALL_MESSAGE)
 

#define ALP_TEL_IS_SPC_PLAY_TONE_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_PLAY_TONE_MESSAGE)
 

#define ALP_TEL_IS_SPC_PRIVATE_CALL_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_PRIVATE_CALL_MESSAGE)
 

#define ALP_TEL_IS_SPC_RELEASE_CALL_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_RELEASE_CALL_MESSAGE)
 

#define ALP_TEL_IS_SPC_SEND_DTMF_STRING_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_SEND_DTMF_STRING_MESSAGE)
 

#define ALP_TEL_IS_SPC_SET_TONE_DURATION_SUPPORTED iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_SPC_SET_TONE_DURATION_MESSAGE)
 

#define ALP_TEL_SPC_ACCEPT_CALL_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0003)
 

#define ALP_TEL_SPC_ADD_HELD_CALL_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0006)
 

#define ALP_TEL_SPC_ALL_ACTIVE_CALLS   0xF1
 

#define ALP_TEL_SPC_ALL_CALLS   0xF0
 

#define ALP_TEL_SPC_ALL_HELD_CALLS   0xF2
 

#define ALP_TEL_SPC_ALS_GET_LINEID_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x000D)
 

#define ALP_TEL_SPC_ALS_GET_LINEID_RANGE_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x000C)
 

#define ALP_TEL_SPC_ALS_SET_LINEID_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x000E)
 

#define ALP_TEL_SPC_CALL_COMPLETION_TO_BUSY_SUBSCRIBER_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0011)
 

#define ALP_TEL_SPC_CALL_DEFLECTION_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x000F)
 

#define ALP_TEL_SPC_CALLER_ID_NOT_AVAILABLE   2
 

#define ALP_TEL_SPC_CALLER_ID_VALID   0
 

#define ALP_TEL_SPC_CALLER_ID_WITHHELD   1
 

#define ALP_TEL_SPC_CALLING_LINE_ID   0xFF
 

ID of a calling line. We can't provide a real ID knowing that an error might occur after TelSpcCallNumber return... So use this one to 'close' the line.

#define ALP_TEL_SPC_DIALING_CALL   0
 

#define ALP_TEL_SPC_DIRECTION_MOBILE_ORIGINATED   0
 

Mobile originated call.

#define ALP_TEL_SPC_DIRECTION_MOBILE_TERMINATED   1
 

Mobile terminated call.

#define ALP_TEL_SPC_DTMF_STRING_MAX_LENGTH   29
 

Max length of the DTMF string.

#define ALP_TEL_SPC_ERROR_CALL_BARRED   2
 

The call has been barred by the network.

#define ALP_TEL_SPC_ERROR_COST_LIMIT   1
 

The call has failed due to cost limit reached.

#define ALP_TEL_SPC_EXPLICIT_CALL_TRANSFERT_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0010)
 

#define ALP_TEL_SPC_GET_CALL_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0001)
 

#define ALP_TEL_SPC_GET_CALLS_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0000)
 

#define ALP_TEL_SPC_GET_TONE_DURATION_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x000A)
 

#define ALP_TEL_SPC_GET_TONE_DURATION_RANGE_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0009)
 

#define ALP_TEL_SPC_GPRS_LINE_ID   0xFE
 

ID of a GPRS line.

#define ALP_TEL_SPC_HOLD_ACTIVE_CALLS_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0005)
 

#define ALP_TEL_SPC_INCOMING_CALL   0xF3
 

#define ALP_TEL_SPC_INITIATE_CALL_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0002)
 

#define ALP_TEL_SPC_MAX_CALL_COUNT   6
 

Max number of calls at the same time.

#define ALP_TEL_SPC_MESSAGES_COUNT   ((ALP_TEL_SPC_SEND_DTMF_STRING_MESSAGE & ALP_TEL_MESSAGE_MASK) + 1)
 

Total count of speech call service messages.

#define ALP_TEL_SPC_MODE_DATA   1
 

Data call.

#define ALP_TEL_SPC_MODE_FAX   2
 

Fax call.

#define ALP_TEL_SPC_MODE_VIDEO   3
 

Video telephony call.

#define ALP_TEL_SPC_MODE_VOICE   0
 

Voice call.

#define ALP_TEL_SPC_PLAY_TONE_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0008)
 

#define ALP_TEL_SPC_PRIVATE_CALL_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0007)
 

#define ALP_TEL_SPC_RELEASE_CALL_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0004)
 

#define ALP_TEL_SPC_SEND_DTMF_STRING_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x0012)
 

#define ALP_TEL_SPC_SET_TONE_DURATION_MESSAGE   ((ALP_TEL_SPC_SERVICE_ID << 8) | 0x000B)
 

#define ALP_TEL_SPC_SS_INFO_CALL_HELD   0x61
 

During a call: Call has been put on hold.

#define ALP_TEL_SPC_SS_INFO_CALL_JOINED   0x63
 

During a call: Multiparty call entered.

#define ALP_TEL_SPC_SS_INFO_CALL_ON_HOLD_RELEASED   0x64
 

During a call: Call on hold has been released.

#define ALP_TEL_SPC_SS_INFO_CALL_RETRIEVED   0x62
 

During a call: Call has been retrieved.

#define ALP_TEL_SPC_SS_INFO_CALL_TRANSFERED   0x36
 

During a mobile terminated call setup or during a call: Call has been connected with the other remote party in explicit call transfer operation.

#define ALP_TEL_SPC_SS_INFO_CALL_TRANSFERED_ACTIVE   0x66
 

During a call: Call has been connected with the other remote party in explicit call transfer operation.

#define ALP_TEL_SPC_SS_INFO_CALL_TRANSFERED_ALERTING   0x65
 

During a call: Call is being connected (alerting) with the remote party in alerting state in explicit call transfer operation.

#define ALP_TEL_SPC_SS_INFO_FORWARD_RECEIVED   0x67
 

During a call: forward check SS message received(can be received whenever).

#define ALP_TEL_SPC_SS_INFO_MO_CALL_DEFLECTED   0x07
 

Originated call setup: Call has been deflected.

#define ALP_TEL_SPC_SS_INFO_MO_CALL_FORWARDED   0x04
 

Originated call setup: Call has been forwarded.

#define ALP_TEL_SPC_SS_INFO_MO_CALL_IS_WAITING   0x02
 

Originated call setup: Call is waiting.

#define ALP_TEL_SPC_SS_INFO_MO_CLIR_SUPPRESSION_REJECTED   0x08
 

Originated call setup: CLIR suppression rejected.

#define ALP_TEL_SPC_SS_INFO_MO_CONDITIONAL_CALL_FORWARD   0x0A
 

Originated call setup: some of the conditional call forwardings are active.

#define ALP_TEL_SPC_SS_INFO_MO_CONNECTED_PARTY_NUMBER   0x01
 

Originated call setup: Connected party number.

#define ALP_TEL_SPC_SS_INFO_MO_CUG_CALL   0x03
 

Originated call setup: This is a CUG call.

#define ALP_TEL_SPC_SS_INFO_MO_INCOMING_CALL_BARRED   0x05
 

Originated call setup: Incoming call is barred(MO).

#define ALP_TEL_SPC_SS_INFO_MO_OUTGOING_CALL_BARRED   0x06
 

Originated call setup: Outgoing call is barred(MO).

#define ALP_TEL_SPC_SS_INFO_MO_UNCONDITIONAL_CALL_FORWARD   0x09
 

Originated call setup: unconditional call forwarding is active.

#define ALP_TEL_SPC_SS_INFO_MT_CALL_DEFLECTED   0x35
 

During a mobile terminated call setup or during a call: This is a deflected call.

#define ALP_TEL_SPC_SS_INFO_MT_CALL_FORWARDED   0x33
 

During a mobile terminated call setup or during a call: This is a forwarded call.

#define ALP_TEL_SPC_SS_INFO_MT_CALLING_PARTY_NAME   0x32
 

During a mobile terminated call setup or during a call: Calling party name(CNA).

#define ALP_TEL_SPC_SS_INFO_MT_CALLING_PARTY_NUMBER   0x31
 

During a mobile terminated call setup or during a call: Calling party number(CLI).

#define ALP_TEL_SPC_SS_INFO_MT_CUG_CALL   0x34
 

During a mobile terminated call setup or during a call: This is a CUG call.

#define ALP_TEL_SPC_STATUS_ACTIVE   0
 

#define ALP_TEL_SPC_STATUS_ALERTING   3
 

MO call.

#define ALP_TEL_SPC_STATUS_DIALING   2
 

MO call.

#define ALP_TEL_SPC_STATUS_HELD   1
 

#define ALP_TEL_SPC_STATUS_INCOMING   4
 

MT call.

#define ALP_TEL_SPC_STATUS_RELEASED   6
 

#define ALP_TEL_SPC_STATUS_WAITING   5
 

MT call.


Typedef Documentation

typedef struct _AlpTelSpcAlsLineIdRangeType AlpTelSpcAlsLineIdRange
 

typedef struct _AlpTelSpcCall AlpTelSpcCall
 

typedef struct _AlpTelSpcCalls AlpTelSpcCalls
 

typedef struct _AlpTelSpcToneDurationRange AlpTelSpcToneDurationRange
 


Function Documentation

alp_status_t alp_tel_spc_accept_call AlpTelApplicationId  iAppId,
AlpTelSpcCall oCallP,
AlpTelTransId ioTransIdP
 

Accepts an incoming call.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[out] oCallP Pointer to a AlpTelSpcCall structure that contains information about the call. Could be NULL if application doesn't want to get any info.
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK The call has been accpeted successfuly.
Since:
ALP iSDK 1.0

alp_status_t alp_tel_spc_add_held_call AlpTelApplicationId  iAppId,
AlpTelTransId ioTransIdP
 

Adds a held call to the conversation.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK The held call has been added successfuly.
Since:
ALP iSDK 1.0

alp_status_t alp_tel_spc_als_get_line_id AlpTelApplicationId  iAppId,
uint16_t *  oLineIdP,
AlpTelTransId ioTransIdP
 

Get the selected line id for the Alternate Line Service.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[out] oLineIdP The selected line id for ALS.
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK The selected line id has been retrieved successfuly.
Since:
ALP iSDK 1.0

alp_status_t alp_tel_spc_als_get_line_id_range AlpTelApplicationId  iAppId,
AlpTelSpcAlsLineIdRange oLineIdRangeP,
AlpTelTransId ioTransIdP
 

Get the range of the line id available for the Alternate Line Service.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[out] oLineIdRangeP A pointer to a AlpTelSpcAlsLineIdRange that will get the available line id for ALS.
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK The ALS line id has been retrieved successfuly.
Since:
ALP iSDK 1.0

alp_status_t alp_tel_spc_als_set_line_id AlpTelApplicationId  iAppId,
uint16_t  iLineId,
AlpTelTransId ioTransIdP
 

Set the line id for the Alternate Line Service.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in] iLineId The line id to select for ALS.
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK The line id has been selected successfuly.
Since:
ALP iSDK 1.0

alp_status_t alp_tel_spc_call_completion_to_busy_subscriber AlpTelApplicationId  iAppId,
AlpTelTransId ioTransIdP
 

Activates the completion of call to busy subscriber request. When a called party is busy, this services enables the calling party to be connected to the called party after its call has been completed.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK Call completion service has been setup successfuly.
Since:
ALP iSDK 1.1

alp_status_t alp_tel_spc_call_deflection AlpTelApplicationId  iAppId,
AlpTelNumber iNumberP,
AlpTelTransId ioTransIdP
 

Causes an incoming or waiting call to be forwarded to a specific number.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in] iNumberP Phone number to forward the incoming or waiting call.
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK The call has been forwarded successfuly.
Since:
ALP iSDK 1.1

alp_status_t alp_tel_spc_explicit_call_transfert AlpTelApplicationId  iAppId,
AlpTelTransId ioTransIdP
 

Connects one active and one held call and disconnects the subscriber from both calls.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK Call has been transfered successfuly.
Since:
ALP iSDK 1.1

alp_status_t alp_tel_spc_get_call AlpTelApplicationId  iAppId,
AlpTelSpcCall ioCallP,
AlpTelTransId ioTransIdP
 

Gets information about a specific call.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in,out] ioCallP Pointer to a AlpTelSpcCall structure, which contains the specific call upon return. On input, the callId field of this structure must be set to identify the call to get information about.
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK The call information has been retrieved successfuly.
Since:
ALP iSDK 1.0

alp_status_t alp_tel_spc_get_calls AlpTelApplicationId  iAppId,
AlpTelSpcCalls ioCallsP,
AlpTelTransId ioTransIdP
 

Gets a list of current calls or the count of them.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in,out] ioCallsP Pointer to a AlpTelSpcCalls structure, which contains the current calls list upon return. On input, if you set the listP field to NULL and count to 0, then this function returns only the count of current calls in count, and errNone. No other call information is returned.
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK The list of current calls has been retrieved successfuly.
Since:
ALP iSDK 1.0

alp_status_t alp_tel_spc_get_tone_duration AlpTelApplicationId  iAppId,
uint16_t *  ioToneDurationP,
AlpTelTransId ioTransIdP
 

Gets the current setting for the length of tones played by the function alp_tel_spc_play_tone().

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in,out] ioToneDurationP Pointer to the length of the tones, in tens of milliseconds (for example, the value 4 means 40 milliseconds).
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK The tone duration has been retrieved successfuly.
Since:
ALP iSDK 1.0

alp_status_t alp_tel_spc_get_tone_duration_range AlpTelApplicationId  iAppId,
AlpTelSpcToneDurationRange ioToneDurationRangeP,
AlpTelTransId ioTransIdP
 

Gets the minimum and maximum length of tones that can be played by the function alp_tel_spc_play_tone().

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in,out] ioToneDurationRangeP Pointer to a AlpTelSpcToneDurationRange structure.
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK The tone duration range has been retrieved successfuly.
Since:
ALP iSDK 1.0

alp_status_t alp_tel_spc_hold_active_calls AlpTelApplicationId  iAppId,
AlpTelTransId ioTransIdP
 

Places all active calls, if any, on hold and accept another (incoming, waiting, or held) call, if any.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK The active calls has been held successfuly.
Since:
ALP iSDK 1.0

alp_status_t alp_tel_spc_initiate_call AlpTelApplicationId  iAppId,
AlpTelSpcCall ioCallP,
AlpTelTransId ioTransIdP
 

Initiates a call.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in,out] ioCallP Pointer to a AlpTelSpcCall structure that must contain the number to dial, and the mode of the call (only ALP_TEL_SPC_MODE_VOICE and ALP_TEL_SPC_MODE_VIDEO mode are supported).
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK The call has been initiated successfuly.
Since:
ALP iSDK 1.0

alp_status_t alp_tel_spc_play_tone AlpTelApplicationId  iAppId,
char  iTone,
AlpTelTransId ioTransIdP
 

Sends DTMF tones.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in] iTone A single ASCII character in the set of 0-9, #, *, and A-D to send.
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK The tone has been played successfuly.
Since:
ALP iSDK 1.0

alp_status_t alp_tel_spc_private_call AlpTelApplicationId  iAppId,
uint8_t  iCallId,
AlpTelTransId ioTransIdP
 

Places all active calls on hold except a specific call.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in] iCallId Call identifier of the call that you want to continue to be active.
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK The call has been put on private successfuly.
Since:
ALP iSDK 1.0

alp_status_t alp_tel_spc_release_call AlpTelApplicationId  iAppId,
uint8_t  iCallId,
AlpTelTransId ioTransIdP
 

Rejects or releases a specific call or releases all active calls, all held calls, or all calls.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in] iCallId Identifier of a specific call to reject or release, or a constant that indicates what kind of calls to release.
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK The call has been released successfuly.
Since:
ALP iSDK 1.0

alp_status_t alp_tel_spc_send_dtmf_string AlpTelApplicationId  iAppId,
char *  iDtmfStringP,
AlpTelTransId ioTransIdP
 

Send a DTMF string.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in] iDtmfStringP A NULL terminated string which is the DTMF string to send.
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK The DTMF string has been sent successfuly.
Since:
ALP iSDK 2.3

alp_status_t alp_tel_spc_set_tone_duration AlpTelApplicationId  iAppId,
uint16_t  iToneDuration,
AlpTelTransId ioTransIdP
 

Sets the duration of tones played by the function alp_tel_spc_play_tone().

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in] iToneDuration Duration of tones, in tens of milliseconds (for example, the value 4 means 40 milliseconds).
[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.
Returns:
ALP_STATUS_OK The tone duration has been set successfuly.
Since:
ALP iSDK 1.0


Generated on Wed Jul 30 07:06:43 2008 by Doxygen 1.4.6 for ALP SDK + Hiker Documentation

Copyright © 1999-2008 ACCESS CO., LTD. All rights reserved.