LINE_APPNEWCALL mensagem

A mensagem tapi LINE_APPNEWCALL é enviada para informar um aplicativo quando um novo identificador de chamada foi criado espontaneamente em seu nome (exceto por meio de uma chamada à 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 entre as 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).

Valor retornado

Sem valor de retorno.

Comentários

Os aplicativos que dão suporte à TAPI versão 2.0 ou posterior recebem uma mensagem de LINE_APPNEWCALL 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 de 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 tem dwParam3 definido como um valor diferente de zero e que contém 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 examinar 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, ele acabou de desalocar seu identificador para a chamada (por exemplo, o aplicativo acabou de desalocar um identificador de chamada, mas uma mensagem LINE_CALLSTATE que dá ao aplicativo a propriedade 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