funzione TSPI_lineReleaseUserUserInfo (tspi.h)

Articolo
08/26/2023

La funzione TSPI_lineReleaseUserUserInfo informa il provider di servizi che le informazioni utente contenute nella struttura LINECALLINFO sono state elaborate e che le informazioni utente ricevute successivamente possono essere scritte in tale struttura. Il provider di servizi invia un messaggio di LINE_CALLINFO che indica LINECALLINFOSTATE_USERUSERINFO quando sono disponibili nuove informazioni.

Sintassi

LONG TSPIAPI TSPI_lineReleaseUserUserInfo(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

Parametri

dwRequestID

Identificatore della richiesta asincrona.

hdCall

Handle del provider di servizi alla chiamata per cui rilasciare le informazioni utente-utente. Lo stato della chiamata di hdCall può essere qualsiasi.

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_OPERATIONFAILED, LINEERR_NOMEM LINEERR_RESOURCEUNAVAIL.

Commenti

La funzione TSPI_lineReleaseUserUserInfo consente il controllo del flusso delle informazioni utente in ingresso su una connessione ISDN. Quando viene ricevuto un nuovo messaggio di informazioni utente completo, il provider di servizi informa TAPI usando un messaggio di LINE_CALLINFO (specificando LINECALLINFOSTATE_USERUSERINFO). Le informazioni utente-utente e altri campi in LINECALLINFO possono essere esaminati da più chiamate a TSPI_lineGetCallInfo. Il provider di servizi non deve sovrascrivere le informazioni utente precedenti in LINECALLINFO con informazioni più recenti fino a quando non viene chiamato TSPI_lineReleaseUserUserInfo . Il provider di servizi deve memorizzare nel buffer le informazioni utente ricevute successivamente fino al rilascio delle informazioni precedenti. Tutte le informazioni memorizzate nel buffer rimanenti possono essere eliminate quando viene richiamato TSPI_lineCloseCall .

Se questa funzione viene richiamata mentre non sono presenti informazioni utente in LINECALLINFO, il provider di servizi deve comunque restituire un'indicazione dell'esito positivo.

Per la compatibilità con le versioni precedenti, TAPI restituisce automaticamente LINEERR_OPERATIONUNAVAIL se questa funzione viene richiamata per una chiamata su una riga sotto il controllo di un provider di servizi che non esporta la funzione.