LINE_APPNEWCALL mensagem

A mensagem LINE_APPNEWCALL TAPI é enviada para informar um aplicativo quando um novo identificador de chamada foi criado espontaneamente em seu nome (exceto por meio de uma chamada de API do aplicativo, nesse caso, o identificador teria sido retornado por meio de um parâmetro de ponteiro passado para a função).

        

Parâmetros

hDevice

O identificador do aplicativo para o dispositivo de linha no qual a chamada foi criada.

dwCallbackInstance

A instância de retorno de chamada fornecida ao abrir a linha da chamada.

Dwparam1

Identificador do endereço na linha na qual a chamada é exibida. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante em atualizações do sistema operacional.

Dwparam2

O identificador do aplicativo para a nova chamada.

dwParam3

O privilégio de aplicativos para a nova chamada (LINECALLPRIVILEGE_OWNER ou LINECALLPRIVILEGE_MONITOR).

Retornar valor

Sem valor de retorno.

Comentários

Aplicativos que dão suporte ao TAPI versão 2.0 ou posterior são enviados LINE_APPNEWCALL mensagem sempre que o aplicativo recebe espontaneamente um identificador para uma nova chamada. Como a mensagem inclui os parâmetros hLine e dwAddressID nos quais a chamada existe, o aplicativo pode criar prontamente um novo objeto de chamada no contexto correto. A mensagem LINE_APPNEWCALL é sempre seguida imediatamente por uma mensagem LINE_CALLSTATE indicando o estado inicial da chamada.

Aplicativos mais antigos (que negociavam uma versão de API anterior à 2.0) são enviados apenas uma mensagem LINE_CALLSTATE , conforme documentado em versões anteriores da API. Esses aplicativos criariam um novo objeto de chamada ao receber uma mensagem LINE_CALLSTATE que tenha dwParam3 definido como um valor não zero e contendo um identificador de chamada não conhecido atualmente pelo aplicativo. As desvantagens são que (a) o aplicativo deve chamar lineGetCallInfo para determinar os parâmetros hLine e dwAddressID associados à chamada; (b) o aplicativo deve verificar todos os identificadores de chamada conhecidos para determinar que a chamada é uma nova chamada; e (c) é possível, em determinadas condições, que o aplicativo pense que está recebendo um novo identificador de chamada quando, na realidade, acaba de desalocar seu identificador para a chamada (por exemplo, o aplicativo acaba de desalocar um identificador de chamada, mas uma mensagem LINE_CALLSTATE que fornece a propriedade do aplicativo da chamada devido a um lineHandoff de outro aplicativo já estava na fila de mensagens TAPI do aplicativo).

Requisitos

Requisito Valor
Versão DO TAPI
Requer TAPI 2.0 ou posterior
Cabeçalho
Tapi.h

Confira também

LINE_CALLSTATE

Linegetcallinfo

lineHandoff