Emergency Calls Service
[Telephony Mgr]

Detailed Description

This service groups the Telephony emergency calls functions.


Data Structures

struct  _AlpTelEmcEmergencyNumbers

Defines

#define ALP_TEL_EMC_DIAL_MESSAGE   ((ALP_TEL_EMC_SERVICE_ID << 8) | 0x0000)
#define ALP_TEL_EMC_GET_EMERGENCY_NUMBERS_MESSAGE   ((ALP_TEL_EMC_SERVICE_ID << 8) | 0x0001)
#define ALP_TEL_EMC_IS_EMERGENCY_NUMBER_MESSAGE   ((ALP_TEL_EMC_SERVICE_ID << 8) | 0x0002)
#define ALP_TEL_EMC_MESSAGES_COUNT   ((ALP_TEL_EMC_IS_EMERGENCY_NUMBER_MESSAGE & ALP_TEL_MESSAGE_MASK) + 1)
 Total count of emergency calls service messages.
#define ALP_TEL_IS_EMC_DIAL_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_EMC_DIAL_MESSAGE)
#define ALP_TEL_IS_EMC_GET_EMERGENCY_NUMBERS_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_EMC_GET_EMERGENCY_NUMBERS_MESSAGE)
#define ALP_TEL_IS_EMC_IS_EMERGENCY_NUMBER_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_EMC_IS_EMERGENCY_NUMBER_MESSAGE)

Typedefs

typedef _AlpTelEmcEmergencyNumbers AlpTelEmcEmergencyNumbers

Functions

alp_status_t alp_tel_emc_dial (AlpTelApplicationId iAppId, AlpTelSpcCall *ioCallP, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_emc_get_emergency_numbers (AlpTelApplicationId iAppId, AlpTelEmcEmergencyNumbers *ioEmergencyNumbersP, AlpTelTransId *ioTransIdP)
alp_status_t alp_tel_emc_is_emergency_number (AlpTelApplicationId iAppId, AlpTelNumber *iNumberP, AlpTelTransId *ioTransIdP)

Define Documentation

#define ALP_TEL_EMC_DIAL_MESSAGE   ((ALP_TEL_EMC_SERVICE_ID << 8) | 0x0000)
 

#define ALP_TEL_EMC_GET_EMERGENCY_NUMBERS_MESSAGE   ((ALP_TEL_EMC_SERVICE_ID << 8) | 0x0001)
 

#define ALP_TEL_EMC_IS_EMERGENCY_NUMBER_MESSAGE   ((ALP_TEL_EMC_SERVICE_ID << 8) | 0x0002)
 

#define ALP_TEL_EMC_MESSAGES_COUNT   ((ALP_TEL_EMC_IS_EMERGENCY_NUMBER_MESSAGE & ALP_TEL_MESSAGE_MASK) + 1)
 

Total count of emergency calls service messages.

#define ALP_TEL_IS_EMC_DIAL_SUPPORTED (  iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_EMC_DIAL_MESSAGE)
 

#define ALP_TEL_IS_EMC_GET_EMERGENCY_NUMBERS_SUPPORTED (  iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_EMC_GET_EMERGENCY_NUMBERS_MESSAGE)
 

#define ALP_TEL_IS_EMC_IS_EMERGENCY_NUMBER_SUPPORTED (  iAppId   )     alp_tel_is_function_supported(iAppId, ALP_TEL_EMC_IS_EMERGENCY_NUMBER_MESSAGE)
 

Typedef Documentation

typedef struct _AlpTelEmcEmergencyNumbers AlpTelEmcEmergencyNumbers
 

Function Documentation

alp_status_t alp_tel_emc_dial (  AlpTelApplicationId  iAppId,
AlpTelSpcCall *  ioCallP,
AlpTelTransId *  ioTransIdP
) 
 

Dial the emergency service.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[out] oCallP Pointer to a AlpTelSpcCall structure, that will have some call infos upon return. A phone number can be specified in the ioCallP->dialNumber.numberP or not, but the pointer must be allocate in both to set the number dialed. If the number specified is a valid emergency number, it will be dialed. Else it will be up to the modem to dial another emergency number that will be set in this field.
[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 emergency service has been dialed successfuly.
Since:
ALP iSDK 1.0

alp_status_t alp_tel_emc_get_emergency_numbers (  AlpTelApplicationId  iAppId,
AlpTelEmcEmergencyNumbers *  ioEmergencyNumbersP,
AlpTelTransId *  ioTransIdP
) 
 

Retrieves the emergency numbers.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in,out] ioEmergencyNumbersP Pointer to a AlpTelEmcEmergencyNumbers structure, that will have the emregcny numbers upon return.
[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 emergency numbers has been retrieved successfuly.
Since:
ALP iSDK 1.0

alp_status_t alp_tel_emc_is_emergency_number (  AlpTelApplicationId  iAppId,
AlpTelNumber *  iNumberP,
AlpTelTransId *  ioTransIdP
) 
 

Check if a phone number is an emergency number.

Parameters:
[in] iAppId The telephone application attachement identifier for your application.
[in] iNumberP Pointer to a AlpTelNumber structure, that have the number to verify.
[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 phone number is an emergency number.

ALP_STATUS_TEL_COMMAND_FAILED The phone number is not an emergency number.

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.