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 |
|