funzione TSPI_lineReleaseUserUserInfo (tspi.h)
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.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tspi.h |