Gebeurtenismelding

Gebeurtenismelding is de primaire methode waarmee een toepassing informatie ophaalt uit TAPI en de serviceproviders. Deze informatie kan de status zijn van een asynchrone bewerking die is geïnstigeerd door de toepassing of kan betrekking hebben op een proces dat buiten de toepassing is gestart, zoals meldingen van nieuwe binnenkomende oproepen.

TAPI 2.x: toepassingen verwerken meldingen op drie manieren: Verborgen venster, gebeurtenisgreep of voltooiingspoort. Zie de sectie Opmerkingen voor lineInitializeExvoor meer informatie over deze meldingsmechanismen. Een toepassing geeft het mechanisme op door de dwOptions- lid van de LINEINITIALIZEEXPARAMS-structuur in te stellen voordat lineInitializeExwordt aangeroepen.

Met de functie lineSetStatusMessages kan een toepassing opgeven welke meldingsberichten moeten worden ontvangen voor gebeurtenissen die betrekking hebben op statuswijzigingen voor de opgegeven regel of een van de bijbehorende adressen.

TAPI 3.x: toepassingen verwerken algemene meldingen met com-standaard-koppelbare objecten. ITTAPIEventNotification is de uitgaande interface die moet worden geregistreerd bij het containerobject van TAPI en ITTAPIEventNotification::Event is de methode TAPI-aanroepen om het antwoord van de toepassing te bepalen. De methode ITTAPI::p ut_EventFilter vertelt TAPI welke gebeurtenissen van belang zijn voor de toepassing. Als er geen gebeurtenisfilter is ingevoerd, ontvangt de toepassing geen melding van gebeurtenissen. De methode ITTAPI::RegisterCallNotifications vertelt TAPI over de mediatypen en adressen waarvoor de toepassing binnenkomende sessies verwerkt. Zie het overzicht van gebeurtenissen gebeurtenissen of het voorbeeld van gebeurtenissen registreren code voor meer informatie over het afhandelen van TAPI 3-gebeurtenissen.

Telefonieserviceproviders implementeren TSPI_lineSetDefaultMediaDetection en TSPI_lineSetStatusMessages. TAPI roept deze functies aan om de set regel-, adres- en mediatype-gebeurtenissen aan te geven die door toepassingen zijn aangevraagd.