LINE_CALLSTATE mensagem
A mensagem LINE_CALLSTATE TAPI é enviada quando o status da chamada especificada é alterado. Normalmente, várias dessas mensagens são recebidas durante o tempo de vida de uma chamada. Os aplicativos são notificados sobre novas chamadas de entrada com esta mensagem; a nova chamada está no estado de oferta . O aplicativo pode usar lineGetCallStatus para recuperar informações mais detalhadas sobre o status atual da chamada.
Parâmetros
-
hDevice
-
Um identificador para a chamada.
-
dwCallbackInstance
-
A instância de retorno de chamada fornecida ao abrir a linha da chamada.
-
Dwparam1
-
O novo estado de chamada. Esse parâmetro deve ser apenas uma das seguintes constantes LINECALLSTATE_.
Dwparam1 Significado - LINECALLSTATE_BUSY
dwParam2 contém detalhes sobre o modo ocupado. Esse parâmetro usa uma das constantes LINEBUSYMODE_. - LINECALLSTATE_CONNECTED
dwParam2 contém detalhes sobre o modo conectado. Esse parâmetro usa uma das constantes LINECONNECTEDMODE_. - LINECALLSTATE_DIALTONE
dwParam2 contém detalhes sobre o modo de tom de discagem. Esse parâmetro usa uma das constantes LINEDIALTONEMODE_. - LINECALLSTATE_OFFERING
dwParam2 contém detalhes sobre o modo conectado. Esse parâmetro usa uma das constantes LINEOFFERINGMODE_. - LINECALLSTATE_SPECIALINFO
dwParam2 contém os detalhes sobre o modo de informações especiais. Esse parâmetro usa uma das constantes LINESPECIALINFO_. - LINECALLSTATE_DISCONNECTED
dwParam2 contém detalhes sobre o modo de desconexão. Esse parâmetro usa uma das constantes LINEDISCONNECTMODE_. -
Dwparam2
-
Informações dependentes de estado de chamada. Consulte dwParam1.
Observação
Em circunstâncias em que uma resposta atrasada é apropriada, use LINEDISCONNECTMODE_TEMPFAILURE. Quando uma resposta na lista de bloqueios for apropriada, use LINEDISCONNECT_BLOCKED. Para obter mais informações, consulte Constantes LINEDISCONNECTMODE_.
Se dwParam1 for LINECALLSTATE_CONFERENCED, dwParam2 conterá o parâmetro hConfCall da chamada pai da conferência da qual o assunto hCall é membro. Se a chamada especificada em dwParam2 não foi considerada anteriormente pelo aplicativo como uma chamada de conferência pai (hConfCall, o aplicativo deve fazê-lo como resultado dessa mensagem. Se o aplicativo não tiver um identificador para a chamada pai da conferência (porque ele já chamou lineDeallocateCall nesse identificador), dwParam2 será definido como NULL.
-
dwParam3
-
Se zero, esse parâmetro indica que não houve nenhuma alteração no privilégio do aplicativo para a chamada.
Se diferente de zero, ele especifica o privilégio do aplicativo para a chamada. Isso ocorre nas seguintes situações: (1) A primeira vez que o aplicativo recebe um identificador para essa chamada; (2) Quando o aplicativo é o destino de uma entrega de chamada (mesmo que o aplicativo já fosse um proprietário da chamada). Esse parâmetro usa uma das seguintes constantes LINECALLPRIVILEGE_.
Valor retornado
Sem valor de retorno.
Comentários
Essa mensagem é enviada para qualquer aplicativo que tenha um identificador para a chamada. A mensagem LINE_CALLSTATE também notifica os aplicativos que monitoram chamadas em uma linha sobre a existência e o estado das chamadas de saída estabelecidas por outros aplicativos ou manualmente pelo usuário (por exemplo, em um dispositivo de telefone anexado). O estado de chamada dessas chamadas reflete o estado real da chamada, que não está oferecendo. Examinando o estado da chamada, o aplicativo pode determinar se a chamada é uma chamada de entrada que precisa ser atendida ou não.
Uma mensagem LINE_CALLSTATE com um estado de chamada desconhecido pode ser enviada a um aplicativo de monitoramento como resultado de um lineMakeCall, lineForward, lineUnpark, lineSetupTransfer, linePickup, lineSetupConference ou linePrepareAddToConference que foi solicitado por outro aplicativo. Ao mesmo tempo em que o aplicativo solicitante recebe um LINE_REPLY (êxito) para a operação solicitada, todos os aplicativos de monitoramento na linha recebem a mensagem LINE_CALLSTATE (desconhecido). Uma mensagem LINE_CALLSTATE indicando o estado de chamada "real" da chamada recém-gerada é enviada (usando informações fornecidas pelo provedor de serviços) para os aplicativos solicitantes e de monitoramento logo depois.
Uma mensagem LINE_CALLSTATE (desconhecida) será enviada para aplicativos de monitoramento somente se lineCompleteTransfer fizer com que as chamadas sejam resolvidas em uma conferência de três vias.
Para compatibilidade com versões anteriores, os aplicativos mais antigos não esperam nenhum valor específico em dwParam2 de uma mensagem de LINECALLSTATE_CONFERENCED. Portanto, o TAPI passa a chamada pai hConfCall em dwParam2 , independentemente da versão da API do aplicativo que recebe a mensagem. No caso de uma chamada em conferência iniciada pelo provedor de serviços, o aplicativo mais antigo não está ciente de que a chamada pai se tornou uma chamada em conferência, a menos que ela examine espontaneamente outras informações (por exemplo, lineGetConfRelatedCalls).
Esta mensagem não pode ser desabilitada.
Requisitos
| Requisito | Valor |
|---|---|
| Versão do TAPI |
Requer TAPI 2.0 ou posterior |
| Cabeçalho |
|