Mensagem _ LINE NEWCALL

A mensagem TSPI LINE _ NEWCALL é enviada para a função de retorno de chamada LINEEVENT sempre que uma nova chamada que a TAPI não originou chega em uma linha aberta pela TAPI. Essa deve ser a primeira mensagem enviada sobre essa chamada. A TAPI grava o handle opaco htCall no local passado pelo provedor de serviços como dwParam2. Isso fornece ao provedor de serviços o valor htCall a ser usado nas mensagens subsequentes.

            

Parâmetros

htLine

O identificador de objeto opaco TAPI para o dispositivo de linha.

Htcall

Não utilizado.

dwMsg

O valor LINE _ NEWCALL.

Dwparam1

O identificador opaco do provedor de serviços para a chamada, do tipo HDRVCALL. A TAPI passa esse valor como o parâmetro hdCall para identificar a chamada nos procedimentos subsequentes invocados para operar na chamada.

Dwparam2

Um ponteiro do tipo LPHTAPICALL apontando para um HTAPICALL. A TAPI grava o handle opaco tapi para a chamada para o local indicado. O provedor de serviços deve salvar esse valor e passá-lo como o parâmetro htCall para identificar a chamada nos eventos subsequentes que ele relata para a chamada.

Esse parâmetro também pode adquirir um valor null (consulte a seção Comentários a seguir).

dwParam3

Não utilizado.

Comentários

O provedor de serviços deve enviar a mensagem LINE _ CALLSTATE como a próxima mensagem para essa chamada. O evento LINE _ NEWCALL é incomum, já que ele também passa um valor de volta para o provedor de serviços.

Essa função relata quaisquer novas chamadas originadas no provedor de serviços (entrada, saída, iniciada no telefone e assim por diante) para as quais a TAPI e o provedor de serviços ainda não trocaram os alças opacas. Os alças são trocados para que a TAPI e o provedor de serviços possam, posteriormente, fazer solicitações e relatar eventos que envolvem a chamada. Como essas novas chamadas não são necessariamente de entrada, as chamadas podem inicialmente estar em qualquer estado, não necessariamente no estado de oferta. Se o provedor de serviços for iniciado e descobrir que uma ou mais chamadas já estão ativas na linha, ele informará a TAPI sobre elas com mensagens LINE _ NEWCALL seguidas por mensagens LINE _ CALLSTATE indicando o estado atual. Uma nova chamada de saída, iniciada no telefone pelo usuário, seria relatada com uma mensagem LINE _ NEWCALL e a mensagem LINE _ CALLSTATE inicial indicaria que a chamada estava no estado DIALTONE (e, em seguida, continuando a partir daí).

Se o provedor de serviços passar um grande número de chamadas para TAPI em um período muito curto (durante o mesmo ciclo de interrupção), a TAPI poderá se tornar registrada em backlogged no processamento dessas chamadas. Quando isso acontece, a TAPI sinaliza para o provedor de serviços aguardar um curto período antes de enviar mais chamadas. Ele sinaliza isso escrevendo um valor null, em vez de um HTAPICALLválido, no local apontado pelo parâmetro dwParam2 de LINE _ NEWCALL. Isso indica que a tentativa de processar o alça de chamada recém-oferecida não foi bem-sucedida, provavelmente devido a uma incapacidade temporária de alocar memória. O provedor de serviços pode responder ao soltar a chamada ou reending a mensagem LINE _ NEWCALL após um atraso de agendamento (durante o qual o provedor de serviços deve produzir o processador para permitir que a TAPI processe outras ações pendentes). Em qualquer caso, nenhuma outra mensagem sobre a nova chamada pode ser passada para TAPI até que a troca de alça seja bem-sucedida. Quando o local apontado por dwParam2 adquire um valor não NULL, o provedor de serviços sabe que esse valor é um alçamento HTAPICALL válido para a chamada.

Não há nenhuma mensagem diretamente correspondente no nível da TAPI. Essa mensagem é usada no nível do TSPI para introduzir de forma exclusiva e inequívoca uma nova chamada de entrada para TAPI e recuperar o identificador opaco tapi para a chamada.

Requisitos

Requisito Valor
Versão do TAPI
Requer TAPI 2.0 ou posterior
Cabeçalho
Tspi.h

Confira também

LINE _ CALLSTATE

LINEEVENT