funzione TSPI_lineAnswer (tspi.h)

Articolo
03/08/2023

La funzione TSPI_lineAnswer risponde alla chiamata di offerta specificata.

Sintassi

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

Parametri

dwRequestID

Identificatore della richiesta asincrona.

hdCall

Handle del provider di servizi alla chiamata da rispondere. Lo stato della chiamata di hdCall può essere offerto o accettato.

lpsUserUserInfo

Puntatore a una stringa con terminazione null contenente le informazioni utente da inviare alla parte remota al momento della risposta alla chiamata. Se questo puntatore è NULL, indica che non devono essere inviate informazioni sull'utente. Le informazioni utente vengono inviate solo se supportate dalla rete sottostante (come indicato in LINEDEVCAPS).

dwSize

Dimensioni in byte delle informazioni utente in lpsUserUserInfo. Se lpsUserUserInfo è NULL, dwSize viene ignorato.

Valore restituito

Restituisce dwRequestID o un numero di errore se si verifica un errore. Il parametro effettivo lResult del ASYNC_COMPLETION corrispondente è zero se la funzione ha esito positivo o un numero di errore se si verifica un errore. I valori restituiti possibili sono i seguenti:

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

Commenti

Quando arriva una nuova chiamata, il provider di servizi invia un messaggio TAPI LINE_NEWCALL per scambiare handle per la chiamata. Il provider di servizi segue questa operazione con un messaggio di LINE_CALLSTATE per informare TAPI e le relative applicazioni client dello stato della chiamata. Un'applicazione client risponde in genere alla chiamata usando TSPI_lineAnswer. In genere, dopo la risposta della chiamata, la chiamata passa allo stato connesso .

In alcuni ambienti di telefonia (ad esempio ISDN) in cui l'avviso utente è separato dall'offerta di chiamate, TAPI e le relative applicazioni client possono avere la possibilità di accettare prima una chiamata prima di rispondere o invece di rifiutare o reindirizzare la chiamata di offerta .

Se viene offerta una chiamata al momento in cui un'altra chiamata è già attiva, la nuova chiamata viene connessa richiamando TSPI_lineAnswer. L'effetto che ha sulla chiamata attiva esistente dipende dalle funzionalità del dispositivo della riga. La prima chiamata potrebbe non essere influenzata, potrebbe essere eliminata automaticamente oppure potrebbe essere inserita automaticamente in attesa. I messaggi di LINE_CALLSTATE appropriati vengono usati per segnalare le transizioni di stato a TAPI su entrambe le chiamate.