SipIncomingCallAssignPhoneLine

The SipIncomingCallAssignPhoneLine event is sent to application software when an incoming call is received. The media engine uses this event to give the application a chance to determine what available phone line to assign the incoming call to. This event can also be used to terminate the incoming phone call similarly to processing the SipIncomingCallInitialized event.

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 ASSIGN_INCOMING_PHONE_LINE structure which contains additional information for this event. Also, setting one of the member variables of the ASSIGN_INCOMING_PHONE_LINE structure will allow your application to terminate the incoming call.