Eventos (API de Telefonia)

Os eventos são uma parte crucial do tratamento de chamadas em TAPI 3. A manipulação de eventos inclui quatro estágios.

Para se registrar e habilitar a recepção de eventos

1. Implemente o método ITTAPIEventNotification::Event . (O TAPI chama esse método quando ocorre um evento.) Normalmente, essa implementação não faz mais do que AdicionarRef o ponteiro da interface IDispatch e, em seguida, postar na bomba de mensagem do aplicativo.

2. Registre a interface de saída ITTAPIEventNotification usando as interfaces padrão COM IConnectionPointContainer e IConnectionPoint e passe o método IConnectionPoint::Advise um ponteiro para ITTAPIEventNotification::Event.

3. Chame o método ITTAPI::p ut_EventFilter para informar à TAPI quais eventos o aplicativo manipulará. O filtro de evento consiste em membros ORda enumeração TAPI_EVENT .

   Observação

   Você deve chamar o método ITTAPI::p ut_EventFilter para definir a máscara de filtro de evento e habilitar a recepção de eventos. Se você não chamar ITTAPI::p ut_EventFilter, seu aplicativo não receberá nenhum evento.

    

Você também deve chamar o método ITTAPI::RegisterCallNotifications para cada objeto de endereço no qual o aplicativo manipulará chamadas.

Consulte Interfaces de evento para obter uma lista de todas as interfaces de evento. Consulte Registrar Eventos para obter exemplos de código que ilustram o processo de registro e Receber uma Chamada para um exemplo de código que mostra um uso de eventos.