função TSPI_lineAddToConference (tspi.h)

Artigo
03/03/2024

A função TSPI_lineAddToConference adiciona a chamada especificada por hdConsultCall à chamada de conferência especificada por hdConfCall.

Sintaxe

LONG TSPIAPI TSPI_lineAddToConference(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdConfCall,
  HDRVCALL      hdConsultCall
);

Parâmetros

dwRequestID

O identificador da solicitação assíncrona.

hdConfCall

O identificador da chamada em conferência. O estado de chamada de hdConfCall pode ser onHoldPendingConference ou onHold.

hdConsultCall

O identificador para a chamada a ser adicionada à chamada de conferência. Essa chamada não pode ser pai de outra conferência ou participante em nenhuma conferência. Dependendo dos recursos do dispositivo indicados em LINEADDRESSCAPS, o parâmetro hdConsultCall pode não ter sido necessariamente estabelecido usando TSPI_lineSetupConference ou TSPI_linePrepareAddToConference. O estado de chamada de hdConsultCall pode ser conectado, onHold, continuando ou ringback.

Retornar valor

Retorna dwRequestID ou um número de erro se ocorrer um erro. O parâmetro real lResult do ASYNC_COMPLETION correspondente será zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_CONFERENCEFULL, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.

Comentários

O provedor de serviços retornará LINEERR_INVALCALLHANDLE se hdConsultCall for pai de outra conferência ou já um participante de uma conferência ou hdConsultCall não puder ser adicionado por outros motivos, como se ele deve ter sido estabelecido usando TSPI_lineSetupConference ou TSPI_linePrepareAddToConference.

Nota O identificador de chamada da parte adicionada permanece válido depois de adicionar a chamada a uma conferência; normalmente, seu estado muda para conferência enquanto o estado da chamada em conferência se torna conectado. O identificador para uma chamada participante individual pode ser usado posteriormente para remover essa parte da chamada em conferência usando TSPI_lineRemoveFromConference.

Os estados de chamada das chamadas que participam de uma conferência não são independentes. Por exemplo, ao descartar uma chamada em conferência, todas as chamadas participantes podem ficar ociosas automaticamente. O TAPI pode consultar os recursos de dispositivo da linha para determinar qual forma de remoção de conferência está disponível. A TAPI ou seus aplicativos cliente devem acompanhar as mensagens LINE_CALLSTATE para determinar o que aconteceu com as chamadas envolvidas.

A chamada em conferência é estabelecida por meio de TSPI_lineSetupConference ou TSPI_lineCompleteTransfer. Normalmente, a chamada adicionada a uma conferência é estabelecida usando TSPI_lineSetupConference ou TSPI_linePrepareAddToConference. Algumas opções podem permitir a adição de uma chamada arbitrária à conferência, e essa chamada pode ter sido configurada usando TSPI_lineMakeCall e estar em espera (dura). Todas as chamadas que fazem parte de uma conferência devem existir na mesma linha aberta.

Qualquer monitoramento (mídia, tons, dígitos) em uma chamada de conferência se aplica apenas ao parâmetro hdConfCall , não às chamadas participantes individuais.

Essa função não tem restrições com base no privilégio, como na função correspondente no nível TAPI. Não há nenhum requisito explícito para que o provedor de serviços acompanhe as relações entre a chamada de conferência "pai" e seus participantes, pois não há correspondência TSPI para a função TAPI. Muitos provedores de serviços podem achar necessário acompanhar essas relações internamente para implementar as outras funções de gerenciamento de chamadas de conferência.