Udostępnij przez


Zdarzenia (interfejs API telefonii)

Zdarzenia są kluczową częścią obsługi wywołań w ramach interfejsu TAPI 3. Obsługa zdarzeń obejmuje cztery etapy.

Aby zarejestrować się i włączyć odbiór zdarzeń

  1. Zaimplementuj metodę ITTAPIEventNotification::Event. (INTERFEJS TAPI wywołuje tę metodę, gdy wystąpi zdarzenie). Zazwyczaj ta implementacja nie przekracza AddRefIDispatch wskaźnika interfejsu, a następnie ogłasza do pompy komunikatów aplikacji.

  2. Zarejestruj interfejs wychodzący ITTAPIEventNotification przy użyciu standardu COM IConnectionPointContainer i interfejsów IConnectionPoint, a następnie przekaż interfejsy IConnectionPoint::Advise metodę wskaźnika do ITTAPIEventNotification::Event.

  3. Wywołaj metodę ITTAPI::p ut_EventFilter, aby poinformować interfejs TAPI o zdarzeniach obsługiwanych przez aplikację. Filtr zdarzeń składa się z LUBelementów członkowskich wyliczania TAPI_EVENT.

    Nuta

    Należy wywołać metodę ITTAPI::p ut_EventFilter, aby ustawić maskę filtru zdarzeń i włączyć odbieranie zdarzeń. Jeśli nie wywołasz ITTAPI::p ut_EventFilter, aplikacja nie będzie otrzymywać żadnych zdarzeń.

     

Należy również wywołać metodę ITTAPI::RegisterCallNotifications dla każdego obiektu adresu, na którym aplikacja będzie obsługiwać wywołania.

Aby uzyskać listę wszystkich interfejsów zdarzeń, zobacz Event Interfaces. Zobacz Rejestrowanie zdarzeń przykłady kodu ilustrujące proces rejestracji i Odbieranie wywołania, aby zapoznać się z przykładem kodu, który pokazuje jedno użycie zdarzeń.