API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

ICALLMGR_ORIGINATE()

Brew Release
Brew MP 1.0.2
See Also
None.
Description
Originates a telephone call of given type to the given destination address. Optionally adds a listener on the call so application is notified of state changes on the telephone call.
Params
pme
[in]:
the Interface pointer.
ct
[in]:
type of call to originate.
pszNumber
[in]:
number to process.
puzAlpha
[in]:
Alpha numeric text for MMI. Can be NULL.
ppCall
[out]:
Creates the ICall object on SUCCESS.
pl
[in]:
A listener to be notified of call states. Can be NULL.
Interface
  • ICALLMGR
Prototype
  •    int ICALLMGR_Originate( ICallMgr *pme, 
                               AEETCallType ct, 
                               const char *pszNumber, 
                               const AECHAR *puzAlpha, 
                               ICall **ppCall,
                               CallListener *pl ); 
    
Return
  • SUCCESS : The call origination is in progress. Applications must register a model listener to keep track of call states to determine if call origination was successful.
    EPRIVLEVEL: if the caller does not have sufficient privilege levels to invoke this function.
    ENOMEMORY: Out of application heap.
    AEET_ERR_OUTOF_RESOURCES : device is out of resources to originate a call.
Side Effect
  • None.
Comments
If the API returns SUCCESS, ppCall will be populated with an AddRef'ed ICall object. It is the callers reponsibility to call ICALL_Release on this object to release its reference An error AEET_ERR_OUTOF_RESOURCES is a temporary condition that is dependent on the state of device and network's capability. For example : If the device is already in a voice call, an originate request for call type AEET_CALL_TYPE_CS_DATA, if the device cannot handle, will likely result in AEET_ERR_OUTOF_RESOURCES.