Notificação de evento

A notificação de eventos é o principal meio pelo qual um aplicativo obtém informações da TAPI e dos provedores de serviços. Essas informações podem ser o status de uma operação assíncrona instigada pelo aplicativo ou podem dizer respeito a um processo iniciado fora do aplicativo, como notificações de novas chamadas recebidas.

TAPI 2.x: aplicativos manipulam a notificação de uma das três maneiras: janela oculta, identificador de evento ou porta de conclusão. Para obter informações adicionais sobre esses mecanismos de notificação, consulte a seção Comentários para lineInitializeEx. Um aplicativo especifica o mecanismo definindo o dwOptions membro da estruturaLINEINITIALIZEEXPARAMS antes de chamar lineInitializeEx.

A função lineSetStatusMessages permite que um aplicativo especifique quais mensagens de notificação receber para eventos relacionados a alterações de status para a linha especificada ou qualquer um de seus endereços.

TAPI 3.x: Aplicativos manipulam notificações gerais usando o padrão COM objetos conectáveis. ITTAPIEventNotification é a interface de saída que deve ser registrada com o objeto de contêiner da TAPI, e ITTAPIEventNotification::Event é o método que a TAPI chama para determinar a resposta do aplicativo. O método ITTAPI::p ut_EventFilter informa à TAPI quais eventos são de interesse para o aplicativo. Se um filtro de evento não for inserido, o aplicativo não receberá notificação de nenhum evento. O métodoITTAPI::RegisterCallNotifications informa à TAPI os tipos de mídia e endereços para os quais o aplicativo manipulará as sessões de entrada. Para obter informações adicionais sobre o tratamento de eventos TAPI 3, consulte a visão geral do de eventos ou o exemplo de código Registrar eventos.

Os provedores de serviços de telefonia implementam TSPI_lineSetDefaultMediaDetection e TSPI_lineSetStatusMessages. A TAPI chama essas funções para indicar o conjunto de todos os eventos de linha, endereço e tipo de mídia solicitados pelos aplicativos.