funzione TSPI_linePrepareAddToConference (tspi.h)

Articolo
08/26/2023

La funzione TSPI_linePrepareAddToConference prepara una chiamata di conferenza esistente per l'aggiunta di un'altra parte. Crea una nuova chiamata di consultazione temporanea. La nuova chiamata di consultazione può essere successivamente aggiunta alla chiamata alla conferenza.

Sintassi

LONG TSPIAPI TSPI_linePrepareAddToConference(
  DRV_REQUESTID          dwRequestID,
  HDRVCALL               hdConfCall,
  HTAPICALL              htConsultCall,
  LPHDRVCALL             lphdConsultCall,
  LPLINECALLPARAMS const lpCallParams
);

Parametri

dwRequestID

Identificatore della richiesta asincrona.

hdConfCall

Handle a una conferenza telefonica. Lo stato della chiamata di hdConfCall può essere connesso.

htConsultCall

Il TAPI gestisce la nuova chiamata di consultazione temporanea. Il provider di servizi deve salvarlo e usarlo in tutte le chiamate successive agli eventi di segnalazione delle procedure LINEEVENT nella nuova chiamata. Lo stato della chiamata di hdAddCall non è applicabile.

lphdConsultCall

Puntatore a un HDRVCALL che rappresenta l'identificatore del provider di servizi per la nuova chiamata di consulenza temporanea. Il provider di servizi deve riempire questa posizione con il relativo handle per la nuova chiamata prima che questa procedura venga restituita. Questo handle non è valido se la funzione genera un errore.

lpCallParams

Puntatore a UN LINECALLPARAMS contenente parametri di chiamata da usare quando si stabilisce la chiamata di consulenza. Questo parametro è impostato su NULL se non sono desiderati parametri di configurazione delle chiamate speciali.

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_BEARERMODEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_CALLUNAVAIL, LINEERR_INVALMEDIAMODE, LINEERR_CONFERENCEFULL, LINEERR_INVALRATE, LINEERR_INUSE, LINEERR_NOMEM, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLPARAMS, LINEERR_RATEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCONFCALLHANDLE, LINEERR_USERUSERINFOTOOBIG.

Commenti

Il provider di servizi restituisce LINEERR_INVALLINESTATE se la riga non è attualmente in uno stato in cui è possibile eseguire questa operazione. Il provider di servizi deve indicare un elenco di operazioni attualmente valide nel membro dwLineFeatures (del tipo LINEFEATURE) nella struttura LINEDEVSTATUS .

Il provider di servizi restituisce LINEERR_INVALCALLSTATE se la conferenza telefonica non è in uno stato valido per l'operazione richiesta.

Questa funzione inserisce una chiamata di conferenza esistente nello stato onHoldPendingConference e crea una chiamata di consultazione che può essere aggiunta in seguito alla chiamata di conferenza esistente con TSPI_lineAddToConference.

La chiamata di consultazione può essere annullata usando TSPI_lineDrop. È anche possibile che TAPI scambi tra la chiamata di consultazione e la chiamata alla conferenza con TSPI_lineSwapHold. Il provider di servizi esegue inizialmente il monitoraggio multimediale sulla nuova chiamata per almeno il set di tipi di supporti monitorati per la riga.

Questa funzione differisce dalla funzione TAPI corrispondente in cui segue il modello TSPI per iniziare la durata di una chiamata. TAPI e gli handle opachi del provider di servizi che rappresentano la chiamata tra loro. Inoltre, il provider di servizi è autorizzato a eseguire callback per la nuova chiamata prima di restituire da questa procedura. In qualsiasi caso, il provider di servizi deve anche considerare l'handle restituito come "non ancora valido" fino a quando la corrispondenza ASYNC_COMPLETION messaggio segnala l'esito positivo. In altre parole, non deve inviare messaggi LINEEVENT per la nuova chiamata o includerlo nei conteggi delle chiamate in messaggi o strutture di dati di stato per la riga.