Notificação de evento

A notificação de evento é o principal meio pelo qual um aplicativo obtém informações do 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 estar relacionadas a um processo iniciado fora do aplicativo, como notificações de novas chamadas de entrada.

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 estrutura deLINEINITIALIZEEXPARAMS 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: Applications manipulam a notificação geral usando objetos conectáveis padrão COM. ITTAPIEventNotification é a interface de saída que deve ser registrada com o objeto de contêiner do TAPI e ITTAPIEventNotification::Event é o método que o 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étodo ITTAPI::RegisterCallNotifications informa à TAPI os tipos de mídia e os endereços para os quais o aplicativo tratará as sessões de entrada. Para obter informações adicionais sobre o tratamento de eventos TAPI 3, consulte a visão geral do Eventos ou o exemplo de código Registrar Eventos.

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