SipIncomingCallInitialized

The SipIncomingCallInitialized event is sent to an application when an incoming call is received. The primary purpose of this event is to give the application the chance to terminate the incoming call before the VOIP Media Engine starts to process the request.


When an application receives this event, the media engine event callback procedure SIPCALLBACKPROC will have a non zero value assigned for the pEventData parameter. This value is a pointer to the INCOMING_CALL_INITIALIZED_DATA structure which contains additional information for this event. Also, setting one of the member variables of the INCOMING_CALL_INITIALIZED_DATA structure will allow your application to terminate the incoming call.

Note:

If your application needs to inform the media engine what available phone line to assign the incoming call to, you should process the SipIncomingCallAssignPhoneLine event.