função TSPI_lineAnswer (tspi.h)

Artigo
03/09/2024

A função TSPI_lineAnswer atende à chamada de oferta especificada.

Sintaxe

LONG TSPIAPI TSPI_lineAnswer(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

Parâmetros

dwRequestID

O identificador da solicitação assíncrona.

hdCall

O identificador do provedor de serviços para a chamada a ser atendida. O estado de chamada do hdCall pode ser oferecido ou aceito.

lpsUserUserInfo

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém informações do usuário-usuário a serem enviadas à parte remota no momento da resposta da chamada. Se esse ponteiro for NULL, ele indicará que nenhuma informação de usuário deve ser enviada. As informações do usuário só serão enviadas se houver suporte da rede subjacente (conforme indicado em LINEDEVCAPS).

dwSize

O tamanho em bytes das informações de usuário-usuário em lpsUserUserInfo. Se lpsUserUserInfo for NULL, dwSize será ignorado.

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 valores retornados possíveis são os seguintes:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INUSE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG.

Comentários

Quando uma nova chamada chega, o provedor de serviços envia ao TAPI uma mensagem LINE_NEWCALL para trocar identificadores para a chamada. O provedor de serviços segue isso com uma mensagem LINE_CALLSTATE para informar a TAPI e seus aplicativos cliente sobre o estado da chamada. Um aplicativo cliente normalmente atende à chamada usando TSPI_lineAnswer. Normalmente, depois que a chamada é atendida com êxito, a chamada faz a transição para o estado conectado .

Em alguns ambientes de telefonia (como o ISDN) em que os alertas de usuário são separados da oferta de chamadas, o TAPI e seus aplicativos cliente podem ter a opção de primeiro aceitar uma chamada antes de responder ou, em vez disso, rejeitar ou redirecionar a chamada de oferta .

Se uma chamada for oferecida no momento em que outra chamada já estiver ativa, a nova chamada será conectada invocando TSPI_lineAnswer. O efeito que isso tem na chamada ativa existente depende dos recursos do dispositivo da linha. A primeira chamada pode não ser afetada, pode ser descartada automaticamente ou pode ser colocada automaticamente em espera. As mensagens de LINE_CALLSTATE apropriadas são usadas para relatar transições de estado para TAPI sobre ambas as chamadas.