função TSPI_lineAccept (tspi.h)

Artigo
08/26/2023

A função TSPI_lineAccept aceita a chamada oferecida especificada. Opcionalmente, ele pode enviar as informações de usuário-usuário especificadas para a parte de chamada.

Sintaxe

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

Parâmetros

dwRequestID

O identificador da solicitação assíncrona.

hdCall

O identificador para a chamada a ser aceita. O estado de chamada do hdCall pode estar oferecendo.

lpsUserUserInfo

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém informações de usuário-usuário a serem enviadas para a parte remota como parte da aceitação da chamada. Esse ponteiro será NULL se nenhuma informação de usuário deve ser enviada. As informações do usuário só serão enviadas se houver suporte para a rede subjacente (consulte LINEDEVCAPS).

dwSize

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

Valor retornado

Retornará dwRequestID se a função for concluída de forma assíncrona ou um número de erro se ocorrer um erro. O parâmetro 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_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_OPERATIONUNAVAIL.

Comentários

A função TSPI_lineAccept é usada em ambientes de telefonia (como ISDN) que permitem que os alertas associados às chamadas de entrada sejam separados da oferta inicial da chamada. Quando uma chamada chega, a chamada é oferecida pela primeira vez. Por algum tempo pequeno, o aplicativo cliente pode ter a opção de rejeitar a chamada usando TSPI_lineDrop, redirecionar a chamada para outra estação usando TSPI_lineRedirect, atender à chamada usando TSPI_lineAnswer ou aceitar a chamada usando TSPI_lineAccept. Depois que uma chamada é aceita com êxito, o alerta no dispositivo chamado e de chamada começa e, normalmente, o estado de chamada faz a transição para o estado aceito . O provedor de serviços deve definir o sinalizador LINEADDRCAPFLAGS_ACCEPTTOALERT no membro dwAddrCapFlags da estrutura de dados LINEADDRESSCAPS se o aplicativo precisar chamar TSPI_lineAccept para que o alerta comece.

Para TAPI, o alerta é relatado usando a mensagem LINE_LINEDEVSTATE com a indicação de toque .

TSPI_lineAccept também podem ser compatíveis com provedores de serviços não ISDN. A transição de estado de chamada para o estado aceito pode ser usada por outros clientes TAPI como uma indicação de que algum aplicativo reivindicou a responsabilidade pela chamada e apresentou a chamada ao usuário.

O aplicativo cliente tem a opção de enviar informações de usuário-usuário no momento da aceitação. Mesmo que as informações de usuário-usuário possam ser enviadas, muitas vezes nenhuma garantia é feita de que a rede fornecerá essas informações à parte de chamada. O aplicativo cliente pode consultar os recursos de dispositivo de uma linha para determinar se a aceitação de chamada está disponível.