Constantes LINECONNECTEDMODE_
As constantes LINECONNECTEDMODE_ sinalizador de bits descrevem subestados diferentes de uma chamada conectada. Um modo está disponível como status de chamada para o aplicativo após a transição do estado da chamada para conectado e dentro da mensagem LINE_CALLSTATE indicando que a chamada está em LINECALLSTATE_CONNECTED. Esses valores são usados quando a chamada está em um endereço compartilhado (em ponte) com outras estações (para obter mais informações, consulte Constantes de LINEADDRESSSHARING_), principalmente sistemas de chaves eletrônicas. Os LINECONNECTEDMODE_constants têm os seguintes valores:
-
LINECONNECTEDMODE_ACTIVE
-
-
Indica que a chamada está conectada na estação atual (a estação atual é um participante na chamada). Se o modo de estado de chamada for 0 (zero), o aplicativo deverá assumir que o valor é "ativo" (que seria a situação em um endereço não ponte). O modo poderá alternar entre ACTIVE e INACTIVE durante uma chamada se o usuário ingressar e sair da chamada por meio de ação manual. Em tal situação de ponte, uma operação lineDrop ou lineHold pode possivelmente não descartar a chamada ou colocá-la em espera, porque a status de outras estações na chamada pode controlar (por exemplo, tentar "segurar" uma chamada quando outras estações estão participando não é possível); em vez disso, a chamada pode ser alterada para o modo INACTIVE se ela permanecer CONECTADA em outras estações.
-
-
LINECONNECTEDMODE_ACTIVEHELD
-
-
Indica que a estação é um participante ativo na chamada, mas que a parte remota colocou a chamada em espera (a outra parte considera que a chamada está no estado de retenção). Normalmente, essas informações estão disponíveis somente quando ambos os pontos de extremidade da chamada se enquadram no mesmo domínio de alternância. Esse sinalizador é exposto somente a aplicativos que negociam uma versão TAPI 2.0 ou superior. (TAPI versões 2.0 e posteriores)
-
-
LINECONNECTEDMODE_CONFIRMED
-
-
Indica que o provedor de serviços recebeu uma notificação afirmativa de que a chamada entrou no estado conectado (por exemplo, por meio de supervisão de resposta ou mecanismos semelhantes). Esse sinalizador é exposto somente a aplicativos que negociam uma versão TAPI 2.0 ou superior. (TAPI versões 2.0 e posteriores)
-
-
LINECONNECTEDMODE_INACTIVE
-
-
Indica que a chamada está ativa em uma ou mais outras estações, mas a estação atual não é um participante da chamada. Se o modo de estado de chamada for ZERO, o aplicativo deverá assumir que o valor é "ativo" (que seria a situação em um endereço não ponte). Uma chamada no estado INACTIVE pode ser unida usando lineAnswer. Muitas operações válidas em chamadas no estado CONNECTED podem ser impossíveis no modo INACTIVE, como monitoramento de tons e dígitos, porque a estação não está realmente participando da chamada; O monitoramento geralmente é suspenso (embora não cancelado) enquanto a chamada está no modo INACTIVE.
-
-
LINECONNECTEDMODE_INACTIVEHELD
-
-
Indica que a estação não é um participante ativo na chamada e que a parte remota colocou a chamada em espera. Esse sinalizador é exposto somente a aplicativos que negociam uma versão TAPI 2.0 ou superior. (TAPI versões 2.0 e posteriores)
-
Comentários
Não extensível. Todos os 32 bits são reservados.
Para compatibilidade com versões anteriores, é responsabilidade do provedor de serviços examinar a versão da API negociada na linha e não usar esses valores LINECONNECTEDMODE_ que não têm suporte na versão negociada. Aplicativos que não estão cientes de LINECONNECTEDMODE_ provavelmente assumirão que uma chamada que está em LINECALLSTATE_CONNECTED está em LINECONNECTEDMODE_ACTIVE.
Os valores LINECONNECTEDMODE_ACTIVE e LINECONNECTEDMODE_INACTIVE são usados quando a chamada está em um endereço que é compartilhado com outras estações (ponte; consulte constantes LINEADDRESSSHARING_), principalmente sistemas de chaves eletrônicas. Se o modo de estado de chamada conectado estiver "ativo", isso significa que a chamada está conectada na estação atual (a estação atual é um participante na chamada). Se o modo de estado de chamada for "inativo", a chamada estará ativa em uma ou mais outras estações, mas a estação atual não será um participante da chamada. Se o modo de estado de chamada for ZERO, o aplicativo deverá assumir que o valor é "ativo" (que seria a situação em um endereço não ponte). O modo poderá alternar entre ACTIVE e INACTIVE durante uma chamada se o usuário ingressar e sair da chamada por meio de ação manual.
Em tal situação de ponte, uma operação lineDrop ou lineHold pode possivelmente não descartar a chamada ou colocá-la em espera, porque o status de outras estações na chamada pode controlar (por exemplo, tentar "segurar" uma chamada quando outras estações estão participando não será possível); em vez disso, a chamada pode simplesmente ser alterada para o modo INACTIVE se ela permanecer conectada em outras estações. Uma chamada no estado INACTIVE pode ser unida usando o lineAnswer.
Muitas operações válidas em chamadas no estado conectado podem ser impossíveis no modo INACTIVE, como monitoramento de tons e dígitos, porque a estação não está realmente participando da chamada; O monitoramento geralmente é suspenso (embora não cancelado) enquanto a chamada está no modo INACTIVE.
Requisitos
| Requisito | Valor |
|---|---|
| Versão do TAPI |
Requer TAPI 2.0 ou posterior |
| Cabeçalho |
|